Insights 管理命令
Insights 管理命令允许用户对其数据系统进行更多控制或收集其他信息。 这些命令分为两个主要类别：
- 管理 - 这些命令允许用户查看有关查询、命令和保留以及更改保留的详细信息
- 数据控制 - 这些命令允许用户创建和删除自定义表、引入本地和云数据以及清除其 DB 中的数据
注意
PlayFab Insights 管理已于 2023 年 12 月 11 日起弃用。 我们建议使用 Azure 数据资源管理器 (ADX) 连接 来管理未来性能和成本。 如果你的游戏仍在使用 Insights，请继续查看本文以了解管理命令详细信息。 有关详细信息，请参阅 Insights 弃用博客。
某些命令在评估模式下不可用。
| 类别 | 命令 |
|---|---|
| 管理 | .show queries .show running queries .show commands-and-queries .show table policy retention .alter table policy retention |
| 数据控制 | .create 表 .drop 表 .set .append .set-or-append .set-or-replace .ingest in table .purge table |
管理
.show queries
返回用户、其他用户或所有用户当前正在执行的查询的列表。
用法：.show queries
示例：.show queries | where StartedOn > ago(1d)
此命令显示在最后一天执行的所有查询
.show running queries
显示当前正在执行的所有查询
用法：.show running queries
示例：.show running queries
此命令显示当前正在运行的所有查询。
.show database policy caching
显示数据库上的当前缓存策略
用法：.show database DatabaseName policy caching
示例：.show database myDatabase policy caching
此命令显示指定数据库的当前缓存策略。
.show table policy caching
显示表上的当前缓存策略
用法：.show database DatabaseName.TableName policy caching
示例：.show database myDatabase.myTable policy caching
此命令显示指定表的当前缓存策略。
.show commands-and-queries
返回一个表，其中包含已达到最终状态的管理员命令和查询。 这些命令和查询可用于查询 30 天。
用法：.show commands-and-queries
示例：.show commands-and-queries | where StartedOn > ago(1d) | where State != "Completed"
此命令显示最后一天失败的所有命令和查询
.show table policy retention
显示考虑群集和数据库规则的表的有效保留策略
用法：.show table(s) (<table_name> [, ...]) policy retention
示例：.show table ['events.all'] policy retention
此命令显示“events.all”表的当前保留策略。
.alter table policy retention（仅限于消费定价模型的账户）
将一个或多个表上的当前保留策略更改为 <retention_policy>
用法：.alter tables (<table_name> [, ...]) policy retention <retention_policy>
示例：.alter table ['events.all'] policy retention softdelete = 90d
此命令设置在 90 天后从“events.all”表中删除其中的数据。
数据控制
.create table（仅限于性能级别 2 及更高版本）
创建新的空表。 该命令必须在特定数据库的上下文中运行。 如果表已存在，则该命令将返回成功。
用法：.create table TableName ([columnName:columnType], ...)
示例：.create table ['custom.logs'] (Level:string, Timestamp:datetime, Id:string, Message:string)
此命令将创建一个名为“custom.logs”的新表，其中包含四列。
重要事项：自定义表必须以“custom”开头。
.drop table（仅限于性能级别 2 及更高版本）
删除指定的表。 注意：此操作无法撤消。
用法：.drop table TableName [ifexists]
示例：.drop table ['custom.logs']
此命令删除名为“custom.logs”的表。
.set（仅限于性能级别 2 及更高版本）
创建包含查询或命令结果的表
用法：.set TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
示例：.set [‘custom.recentEvents’] <| [‘events.all’] | where Timestamp > now() – time(1h)
此命令创建表“custom.recentEvents”，其中包含上述查询的结果
.append（仅限于性能级别 2 及更高版本）
将 QueryOrCommand 的结果附加到现有表
用法：.append TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
示例：.append [‘custom.recentEvents’] <| [‘events.all’] | where Timestamp > now() – time(1h)
此命令将上述查询的结果添加到现有表“custom.recentEvents”
.set-or-append（仅限于性能级别 2 及更高版本）
将 QueryOrCommand 的结果创建或附加到现有表
用法：.set-or-append TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
示例：.set-or-append [‘custom.weekEvents’] <| [‘events.all’] | where Timestamp > now() – time(7d)
此命令将上述查询中的数据附加到表“custom.weekEvents”。 如果表格不存在，请创建表格。
.set-or-replace（仅限于性能级别 2 及更高版本）
如果表中的数据存在，则替换该数据（删除现有的数据分片），如果不存在，则创建目标表。 除非 extend_schema 或 recreate_schema 引入属性中有一个设为 true，否则保留表架构。 如果修改了架构，则会在实际数据引入到其自己的事务中之前发生修改，因此，无法引入数据并不意味着架构未被修改。
用法：.set-or-replace TableName [with (PropertyName = PropertyValue [, ...])] <| QueryOrCommand
示例：.set-or-replace [‘custom.dayEvents’] <| [‘events.all’] | where Timestamp > now() – time(1d)
此命令将表“custom.dayEvents”中的数据替换为上述查询。
.ingest into（仅限于性能级别 2 及更高版本）
通过从一个或多个云存储工件中“拉取”数据，将数据引入表中。
用法：.ingest into table TableName SourceDataLocator [with ( IngestionPropertyName = IngestionPropertyValue [, ...] )]
示例：.ingest into table [‘custom.myData’] (h’<your url here>’) with(ignoreFirstRecord=true)
此命令将数据从 URL 中列出的云存储推送到表“custom.myData”。
.purge table（仅限于性能级别 2 及更高版本）
从数据库中永久删除表中的数据
用法：.purge table [TableName] in database [DatabaseName] allrecords with (noregrets='true')
示例：.purge table [‘custom.toPurge’] in database MyDatabase allrecords
此命令清除表“custom.toPurge”中的所有数据，并从数据系统中永久删除该数据。