graph_query图形模型策略(预览版)

使用 “版本 ”下拉列表切换服务。 了解有关导航的详细信息。
适用于: ✅ Azure 数据资源管理器

注释

此功能目前处于预览阶段。 正式发布之前,功能和语法可能会更改。

策略 graph_query 控制图形模型的图形查询行为。

策略控制当查询引用图形模型而不命名快照时选择哪个快照。 例如,该策略适用于使用的 graph("MyGraph")查询。 当查询命名特定快照时,它不适用。

默认值DefaultSnapshotQueryBehavior为 LatestSnapshot 。

如果查询为特定快照命名,该快照必须可用于查询。 如果命名快照尚不可用,查询将失败。 如果查询未命名快照, LatestSnapshot 请选择最新的可用快照,而不考虑索引状态。 LatestIndexedSnapshot 选择满足模型 snapshot_indexing 策略的最新可用快照。

Permissions

若要显示策略,需要 数据库监视器或数据库查看器权限。

若要更改或删除策略,需要对图形模型拥有 Graph 管理员权限。

Syntax

.show graph_model GraphModelNamepolicygraph_query

.show graph_model * policy graph_query

.alter graph_model GraphModelNamepolicygraph_queryPolicyObject

.delete graph_model GraphModelNamepolicygraph_query

Parameters

Name 类型 Required Description
GraphModelName String ✅ 图形模型名称。
PolicyObject String ✅ 用于 .alter 一个 JSON 策略对象。
DefaultSnapshotQueryBehavior String ✅ 的快照选择行为 graph("model")。 支持的值是 LatestSnapshot 和 LatestIndexedSnapshot。

默认快照查询行为

Value Description
LatestSnapshot 使用最新的可用快照,而不考虑索引状态。 这是默认值。
LatestIndexedSnapshot 使用满足模型 snapshot_indexing 策略的最新可用快照。 如果没有可用的匹配快照,查询将失败并出现明确的错误。

删除策略会还原默认行为。

Returns

此命令返回具有以下列的表:

列 类型 Description
PolicyName String 策略名称。
实体名称 String 图形模型名称。
Policy String 策略的 JSON 表示形式。
ChildEntities String 保留。
EntityType String 实体类型。

Examples

显示图形模型的策略

.show graph_model MyGraph policy graph_query

显示所有图形模型的策略

.show graph_model * policy graph_query

使用最新的可用快照

.alter graph_model MyGraph policy graph_query ```
{
  "DefaultSnapshotQueryBehavior": "LatestSnapshot"
}
```

使用满足索引策略的最新快照

.alter graph_model MyGraph policy graph_query ```
{
  "DefaultSnapshotQueryBehavior": "LatestIndexedSnapshot"
}
```

删除策略

.delete graph_model MyGraph policy graph_query