图探索

探索和可视化您的图类型、字段和关系

当您的图图增长时，理解其结构可能会变得更困难。如果不了解模式（尤其是子图如何相互关联）的复杂性，开发可能会受阻或走向错误的方向。

GraphOS Studio提供了多种理解和探索您组织图中图的方式，包括：

ⓘ 注意

这些GraphOS Studio功能适用于所有图的类型。对于特定于超级图的功能，请参阅超级图专用Studio功能。请参阅变体页面以获取Studio页面的完整列表。

在GraphOS Studio中选择了组织后，点击特定的图变体以查看其页面。

使用无服务器和专用计划，所有 Studio 组织成员都可以访问所有页面，包括设置组织内所有图形的成员角色企业账户可以设置成员角色以配置组织中个别成员的细粒度访问。

当用户在 GraphOS Studio 中打开您的其中一个 graph 的变体时，其 README 页出现：

类似于 Git 仓库的典型主页，此页面显示可以编辑任何内容的基于 Markdown 的 README。

ⓘ 注意

只有具有 组织管理员，图形管理员，捐献者 或 文档员 角色子可以编辑变体的 README。如果一个变体受保护，则 捐献者 无法编辑其 README。

每个 variant 都有自己的 README。如果您编辑一个变体的 README，那些编辑不会应用到其他变体。除其他用途外，这允许您在不同公开变体中向外部消费者提供不同的信息。

README 支持所有基本 Markdown 语法和大多数扩展语法，包括表格、代码块和脚注。

您可以使用以下语法定义一个 GraphQL 代码块：

1
```graphql
2
query MyQuery {
3
  users {
4
    id
5
    name
6
  }
7
}
8
```

这将在代码块中呈现具有复制操作或打开它在探索者中的按钮。

README 支持一组短代码。这些短代码可以根据你的 variant 自动填充 README 的数据，例如 graph's 名称和 variant 的 graph ref：

1
# Overview of {{ graph.name }}
2

3
Graph ref: {{ graph.ref }}

要查看所有支持的短代码，请点击 README 编辑器的左下角的 Graph shortcodes。

graph 变量的 Schema 页面有三种不同的视图：

模式页面上的 Reference 选项卡列出了您模式中不同类型的定义，例如对象、scalars、接口等。

选择一种定义类型，查看所有相关类型的表格

表格中的每个类型定义包括

类型的名称
- 您可以点击名称查看类型的更多详细信息，如下 fields 对象的字段，或联合的可能类型。
类型的描述，如果您的模式包含描述的话
哪些 subgraphs 定义了类型，如果您有一个联邦 supergraph
- 具有 Consumer 角色的用户无法查看 subgraph 详细信息。

在 Schema 页面的顶部提供了一个 Filter Schema 框，您可以使用它来找到与一组过滤器匹配的类型和 fields：

💡 提示

您设置的任何过滤器都会在您在模式页面之间移动时保持激活状态。

您可以根据类型/field 名称过滤模式定义，如上所示，以及以下组合中的任何组合：

过滤	描述	示例
`subgraph`	包括任何指定 subgraphs 中定义的结果。仅适用于联邦 supergraphs。	`subgraph:products,reviews`
`tag`	如果你的图表使用了 `@tag` 指令，请包括具有指定名称之一的 `@tag` 的结果。如果正在查看对象表，还包括至少有一个具有指定字段的对象。如果你的图表没有使用 `@tag` 指令，则此过滤器不可用。	`标签：内部、实验`
`指令`	包括应用了任何指定指令的结果。如果正在查看对象表，还包括至少有一个具有指定指令的字段的对象。	`指令：弃用、未使用`
`返回类型`	包括具有任何指定返回类型的结果。如果正在查看对象表，包括至少有一个具有指定返回类型的字段的对象。此过滤器包括所有返回特定类型的字段，无论每个字段的nullability或它是否返回列表。例如，如果您指定 `returnType:Int`，则过滤器包括返回字段 `Int`、`Int!` 或 `[Int]` 的任何字段。	`返回类型：Int，String`
`参数`	包括使用任何指定名称的 GraphQL 参数的结果。如果正在查看对象表，也包括至少有一个具有指定参数的字段的对象。	`参数：offset，limit`

在单个过滤器中列出多个可能值时，这些值使用或逻辑。
- 例如，如果通过 subgraph:products,reviews 过滤，则结果包括每个子图中的定义。
如果您应用了多种类型的过滤器，则这些过滤器使用与逻辑。
- 例如，如果通过 subgraph:products 和 returnType:Int 过滤，则结果只包括满足这两个条件的定义。
目前，无法对同一类型的多个过滤器使用与逻辑。
- 例如，无法通过 subgraph:products 与与 subgraph:reviews 包含只在两个子图中都存在的定义。