適用於：
Azure Data CLI (azdata)
備註
過去由 Azure Data CLIazdata（） 處理的部分情境，現在透過 Azure CLI （az） 擴充功能 及 基於 Azure Arc 的工作流程來管理。 沒有一個單一 azdata 的 1：1 指令替換。 下表列出常見相關的 Azure CLI 替代方案（若有）。
| AZDATA 指揮區 | Azure CLI extension / command group | Azure CLI 參考資料 |
|---|---|---|
azdata arc dc * |
az arcdata |
Azure Arc data CLI reference |
azdata arc sql mi * |
az arcdata sql mi |
Manage Azure SQL Managed Instance with CLI |
azdata arc postgres * |
az arcdata postgres |
用 CLI 管理 PostgreSQL 伺服器 |
azdata migrate * |
az datamigration |
使用 CLI 進行遷移 |
azdata extension * |
az extension * |
Azure CLI extensions overview |
azdata login |
az login |
AZ Login |
azdata sql shell / azdata sql query |
沒有 Azure CLI 的對應工具（使用 sqlcmd、SSMS 或其他 SQL 工具） |
sqlcmd 公用程式 SQL Server 管理工作室 |
對於新的自動化與管理場景，建議使用 Azure CLI （az）、Azure CLI 擴充套件及 Azure Arc 入口網站體驗。
下列文章提供 azdata 工具中 sql 命令的參考。 如需其他 azdata 命令的詳細資訊，請參閱 azdata 參考。
Commands
| 命令 | 說明 |
|---|---|
| Azdata Arc | Commands for using Azure Arc for Azure data services. |
| azdata SQL | SQL DB CLI 允許使用者透過 T-SQL 與 SQL Server 互動。 |
| azdata login | 登入叢集的控制器端點，並將其命名空間設為你的主動上下文。 登入時要使用密碼，必須設定AZDATA_PASSWORD環境變數。 |
| azdata logout | 登出叢集。 |
| azdata context | 上下文管理指令。 |
| Azdata BDC | 選擇、管理並操作 SQL Server 大數據叢集。 |
| AZDATA 擴充 | 管理及更新 CLI 延伸模組。 |
| Azdata 應用程式 | 建立、刪除、執行及管理應用程式。 |
| Azdata Postgres | Postgres 查詢執行器與互動殼層。 |
| Azdata notebook | 用於從終端機檢視、執行及管理筆記本的指令。 |
azdata login
當你的叢集部署時，會在部署時列出控制器端點，你應該用它來登入。 如果你不熟悉控制器端點，你可以在系統中將叢集的 kube 設定放在預設位置 <user home>/.kube/config 來登入，或使用 KUBECONFIG env var，例如匯出 KUBECONFIG=path/to/.kube/config。當你登入時，這個叢集的命名空間會被設定為你的主動上下文。
azdata login [--auth]
[--endpoint -e]
[--accept-eula -a]
[--namespace -ns]
[--username -u]
[--principal -p]
Examples
使用基本認證登入。
azdata login --auth basic --username johndoe --endpoint https://<ip or domain name>:30080
使用 Active Directory 登入。
azdata login --auth ad --endpoint https://<ip or domain name>:30080
使用明確的 Principal 使用 Active Directory 登入。
azdata login --auth ad --principal johndoe@COSTOSO.COM --endpoint https://<ip or domain name>:30080
以互動方式登入。 若未指定為參數，叢集名稱將永遠被提示。 如果你系統上設定了AZDATA_USERNAME、AZDATA_PASSWORD和ACCEPT_EULA env 變數，這些都不會被提示。 如果你的系統有 kube 設定檔，或是用 KUBECONFIG env var 來指定設定路徑，互動體驗會先嘗試使用設定檔，然後如果設定失敗會提示你。
azdata login
登入（非互動式）。 登入時會用叢集名稱、控制器使用者名稱、控制器端點和 EULA 接受設定作為參數。 必須設定環境變數AZDATA_PASSWORD。 如果你不想指定控制器端點，請將 kube 設定在你機器上的預設位置 <user home>/.kube/config，或使用 KUBECONFIG env var，例如匯出 KUBECONFIG=path/to/.kube/config。
azdata login --namespace ClusterName --username johndoe@contoso.com --endpoint https://<ip or domain name>:30080 --accept-eula yes
在機器上用 kube 設定登入，並設定 env var 分別設定為 AZDATA_USERNAME、AZDATA_PASSWORD 和 ACCEPT_EULA。
azdata login -n ClusterName
選擇性參數
--auth
認證策略。 基本或 Active Directory 認證。 預設是「基本」認證。
--endpoint -e
叢集控制器端點「https://host:port". 如果你不想用這個 ARG，可以用你機器上的 kube 設定。 請確保設定檔位於使用者 home>/.kube/config 的預設位置<，或使用 KUBECONFIG env var。
--accept-eula -a
你接受授權條款嗎？ [是/否]。 如果你不想使用這個 ARG，可以將環境變數 ACCEPT_EULA 設為「是」。 本產品的授權條款可於 https://aka.ms/eula-azdata-en.（
--namespace -ns
叢集控制平面的命名空間。
--username -u
帳號使用者。 如果你不想使用這個 ARG，可以設定環境變數 AZDATA_USERNAME。
--principal -p
你的Kerberos領域。 在大多數情況下，你的 Kerberos 領域就是你的網域名稱，但用大寫字母表示。
全域引數
--debug
提高日誌詳細程度以顯示所有調試日誌。
--help -h
顯示此說明訊息並結束。
--output -o
輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。
--query -q
JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。
--verbose
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。
azdata logout
登出叢集。
azdata logout
Examples
登出此使用者。
azdata logout
全域引數
--debug
提高日誌詳細程度以顯示所有調試日誌。
--help -h
顯示此說明訊息並結束。
--output -o
輸出格式。 允許的值：json、jsonc、table、tsv。 預設值：json。
--query -q
JMESPath 查詢字串。 如需詳細資訊和範例，請參閱 http://jmespath.org/。
--verbose
增加記錄的詳細程度。 針對完整偵錯記錄使用 --debug。
下一步
如需其他 azdata 命令的詳細資訊，請參閱 azdata 參考。
如需如何安裝 azdata 工具的詳細資訊，請參閱安裝 azdata。