Share via

az datashare data-set

  • 實驗
  • 參考

注意

此參考是 Azure CLI 的資料共用 延伸模組的一部分 （2.15.0 版或更高版本）。 擴充功能會在您第一次執行 az datashare data-set 命令時自動安裝。 深入了解擴充功能。

命令群組 'datashare' 是實驗性且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

使用 datashare 管理資料集。

命令

名稱 Description 類型 狀態
az datashare data-set create

建立 DataSet。

 擴充 實驗性
az datashare data-set delete

刪除共用中的 DataSet。

 擴充 實驗性
az datashare data-set list

列出共用中的資料集。

 擴充 實驗性
az datashare data-set show

在共用中取得 DataSet。

 擴充 實驗性
az datashare data-set wait

將 CLI 置於等候狀態，直到符合 datashare 資料集的條件為止。

 擴充 實驗性

az datashare data-set create

實驗

命令群組 'datashare' 是實驗性且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

建立 DataSet。

az datashare data-set create --account-name
                             --data-set
                             --data-set-name
                             --resource-group
                             --share-name

範例

DataSets_Create

az datashare data-set create --account-name "Account1" --data-set "{\"kind\":\"Blob\",\"properties\":{\"containerName\":\"C1\",\"filePath\":\"file21\",\"resourceGroup\":\"SampleResourceGroup\",\"storageAccountName\":\"storage2\",\"subscriptionId\":\"433a8dfd-e5d5-4e77-ad86-90acdc75eb1a\"}}" --name "Dataset1" --resource-group "SampleResourceGroup" --share-name "Share1"

DataSets_KustoCluster_Create

az datashare data-set create --account-name "Account1" --data-set "{\"kind\":\"KustoCluster\",\"properties\":{\"kustoClusterResourceId\":\"/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.Kusto/clusters/Cluster1\"}}" --name "Dataset1" --resource-group "SampleResourceGroup" --share-name "Share1"

DataSets_KustoDatabase_Create

az datashare data-set create --account-name "Account1" --data-set "{\"kind\":\"KustoDatabase\",\"properties\":{\"kustoDatabaseResourceId\":\"/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.Kusto/clusters/Cluster1/databases/Database1\"}}" --name "Dataset1" --resource-group "SampleResourceGroup" --share-name "Share1"

DataSets_KustoTable_Create

az datashare data-set create --account-name "Account1" --data-set "{\"kind\":\"KustoTable\",\"properties\":{\"kustoDatabaseResourceId\":\"/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.Kusto/clusters/Cluster1/databases/Database1\",\"tableLevelSharingProperties\":{\"externalTablesToExclude\":[\"test11\",\"test12\"],\"externalTablesToInclude\":[\"test9\",\"test10\"],\"materializedViewsToExclude\":[\"test7\",\"test8\"],\"materializedViewsToInclude\":[\"test5\",\"test6\"],\"tablesToExclude\":[\"test3\",\"test4\"],\"tablesToInclude\":[\"test1\",\"test2\"]}}}" --name "Dataset1" --resource-group "SampleResourceGroup" --share-name "Share1"

DataSets_SqlDBTable_Create

az datashare data-set create --account-name "Account1" --data-set "{\"kind\":\"SqlDBTable\",\"properties\":{\"databaseName\":\"SqlDB1\",\"schemaName\":\"dbo\",\"sqlServerResourceId\":\"/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.Sql/servers/Server1\",\"tableName\":\"Table1\"}}" --name "Dataset1" --resource-group "SampleResourceGroup" --share-name "Share1"

DataSets_SqlDWTable_Create

az datashare data-set create --account-name "Account1" --data-set "{\"kind\":\"SqlDWTable\",\"properties\":{\"dataWarehouseName\":\"DataWarehouse1\",\"schemaName\":\"dbo\",\"sqlServerResourceId\":\"/subscriptions/433a8dfd-e5d5-4e77-ad86-90acdc75eb1a/resourceGroups/SampleResourceGroup/providers/Microsoft.Sql/servers/Server1\",\"tableName\":\"Table1\"}}" --name "Dataset1" --resource-group "SampleResourceGroup" --share-name "Share1"

DataSets_SynapseWorkspaceSqlPoolTable_Create

az datashare data-set create --account-name "sourceAccount" --data-set "{\"kind\":\"SynapseWorkspaceSqlPoolTable\",\"properties\":{\"synapseWorkspaceSqlPoolTableResourceId\":\"/subscriptions/0f3dcfc3-18f8-4099-b381-8353e19d43a7/resourceGroups/SampleResourceGroup/providers/Microsoft.Synapse/workspaces/ExampleWorkspace/sqlPools/ExampleSqlPool/schemas/dbo/tables/table1\"}}" --name "dataset1" --resource-group "SampleResourceGroup" --share-name "share1"

必要參數

--account-name

共用帳戶的名稱。

--data-set

新的資料集資訊。 預期值：json-string/json-file/@json-file。

--data-set-name --name -n

DataSet 的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--share-name

要加入資料集的共用名稱稱。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az datashare data-set delete

實驗

命令群組 'datashare' 是實驗性且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

刪除共用中的 DataSet。

az datashare data-set delete [--account-name]
                             [--data-set-name]
                             [--ids]
                             [--no-wait]
                             [--resource-group]
                             [--share-name]
                             [--subscription]
                             [--yes]

範例

DataSets_Delete

az datashare data-set delete --account-name "Account1" --name "Dataset1" --resource-group "SampleResourceGroup" --share-name "Share1"

選擇性參數

--account-name

共用帳戶的名稱。

--data-set-name --name -n

DataSet 的名稱。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--no-wait

請勿等候長時間執行的作業完成。

預設值: False
--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--share-name

共用的名稱。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--yes -y

不提示確認。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az datashare data-set list

實驗

命令群組 'datashare' 是實驗性且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

列出共用中的資料集。

az datashare data-set list --account-name
                           --resource-group
                           --share-name
                           [--filter]
                           [--orderby]
                           [--skip-token]

範例

DataSets_ListByShare

az datashare data-set list --account-name "Account1" --resource-group "SampleResourceGroup" --share-name "Share1"

必要參數

--account-name

共用帳戶的名稱。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--share-name

共用的名稱。

選擇性參數

--filter

使用 OData 語法篩選結果。

--orderby

使用 OData 語法排序結果。

--skip-token

接續權杖。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az datashare data-set show

實驗

命令群組 'datashare' 是實驗性且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

在共用中取得 DataSet。

az datashare data-set show [--account-name]
                           [--data-set-name]
                           [--ids]
                           [--resource-group]
                           [--share-name]
                           [--subscription]

範例

DataSets_Get

az datashare data-set show --account-name "Account1" --name "Dataset1" --resource-group "SampleResourceGroup" --share-name "Share1"

選擇性參數

--account-name

共用帳戶的名稱。

--data-set-name --name -n

DataSet 的名稱。

--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--share-name

共用的名稱。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。

az datashare data-set wait

實驗

命令群組 'datashare' 是實驗性且正在開發中。 參考和支援層級： https://aka.ms/CLI_refstatus

將 CLI 置於等候狀態，直到符合 datashare 資料集的條件為止。

az datashare data-set wait [--account-name]
                           [--created]
                           [--custom]
                           [--data-set-name]
                           [--deleted]
                           [--exists]
                           [--ids]
                           [--interval]
                           [--resource-group]
                           [--share-name]
                           [--subscription]
                           [--timeout]
                           [--updated]

範例

暫停執行下一行 CLI 腳本，直到成功刪除 datashare 資料集為止。

az datashare data-set wait --account-name "Account1" --name "Dataset1" --resource-group "SampleResourceGroup" --share-name "Share1" --deleted

選擇性參數

--account-name

共用帳戶的名稱。

--created

請等候在 'Succeeded' 使用 'provisioningState' 建立。

預設值: False
--custom

等到條件符合自訂 JMESPath 查詢為止。 例如 provisioningState！='InProgress'， instanceView.statuses[？code=='PowerState/running']。

--data-set-name --name -n

DataSet 的名稱。

--deleted

等到刪除為止。

預設值: False
--exists

等候資源存在。

預設值: False
--ids

一或多個資源識別碼 (以空格分隔)。 它應該是包含 「資源識別碼」引數所有資訊的完整資源識別碼。 您應該提供 --ids 或其他「資源識別碼」引數。

--interval

輪詢間隔以秒為單位。

預設值: 30
--resource-group -g

資源組名。 您可以使用 來設定預設群組 az configure --defaults group=<name> 。

--share-name

共用的名稱。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--timeout

以秒為單位的等候上限。

預設值: 3600
--updated

等到 provisioningState 更新為 'Succeeded'。

預設值: False
全域參數
--debug

增加記錄詳細資訊，以顯示所有偵錯記錄。

--help -h

顯示此說明訊息並結束。

--only-show-errors

只顯示錯誤，隱藏警告。

--output -o

輸出格式。

接受的值: json, jsonc, none, table, tsv, yaml, yamlc
預設值: json
--query

JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。

--subscription

訂用帳戶的名稱或識別碼。 您可以使用 來設定預設訂用 az account set -s NAME_OR_ID 帳戶。

--verbose

增加記錄詳細資訊。 使用 --debug 來取得完整偵錯記錄。