插件配置
插件配置隐藏全局字段

隐藏全局字段

全局字段会被添加到 GraphQL schema 的所有类型中,这会使其可视化变得难以管理:

所有类型下均公开全局字段的 schema

因此,配置(见下一节)提供了以下方式之一,在(执行内省时)不公开全局字段:

  • 仅在 Root 类型下公开
  • 完全不公开

即使全局字段未被公开,它们在 schema 的所有类型下仍然可用;换句话说,执行内省时它们只是"从视图中隐藏"。如果您希望从 schema 中实际删除(而非仅仅隐藏)某个全局字段,则必须通过 Access Control List 来实现。

默认情况下,schema 仅在 Root 类型下公开全局字段,这样更易于可视化和浏览:

仅在 Root 类型下公开全局字段的 schema

配置

要选择 GraphQL schema 中全局字段的总体公开级别,请转到设置页面中的「Global Fields」模块,并选择所需选项:

  • 不公开
  • 仅在 Root 类型下公开 (这是默认值)
  • 在所有类型下公开
全局字段的设置
全局字段的设置

要在不同的自定义端点上修改全局字段的公开方式,请在编辑对应的 Schema 配置时,在「Global Fields」区块中选择所需选项:

在 Schema 配置中编辑全局字段