Insights 管理命令

Insights 管理命令可讓使用者對其資料系統進行更多控制，或收集更多相關資訊。這些命令分為兩個主要類別：

1. 管理 - 這些命令可讓使用者檢視更多關於查詢、命令、保留的資訊，以及變更保留
2. 資料控制 - 這些命令可讓使用者建立和卸除自訂資料表、擷取本機和雲端資料，以及從其資料庫清除資料

部分命令在評估模式中無法使用。

​

管理

.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 此命令會設定 “events.all” 資料表中的資料在 90 天後從資料表中移除。

​

資料控制

.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” 中的所有資料，將其從您的資料系統中永久刪除。