적용 대상:
Azure Data CLI(azdata)
메모
이전에 Azure Data CLI(azdata)에서 처리한 일부 시나리오는 이제 Azure CLI(az) 확장 및 Azure Arc 기반 워크플로를 통해 관리됩니다. 모든 azdata 명령에 대한 단일 1:1 대체는 없습니다. 다음 표에서는 일반적으로 관련된 Azure CLI 대안이 존재하는 위치를 중점적으로 설명합니다.
| azdata 명령 영역 | Azure CLI 확장/명령 그룹 | Azure CLI 참조 |
|---|---|---|
azdata arc dc * |
az arcdata |
Azure Arc 데이터 CLI 참조 |
azdata arc sql mi * |
az arcdata sql mi |
CLI를 사용하여 Azure SQL Managed Instance 관리 |
azdata arc postgres * |
az arcdata postgres |
CLI를 사용하여 PostgreSQL 서버 관리 |
azdata migrate * |
az datamigration |
CLI를 사용하여 마이그레이션 |
azdata extension * |
az extension * |
Azure CLI 확장 개요 |
azdata login |
az login |
az login |
azdata sql shell / azdata sql query |
Azure CLI에 해당하지 않음(사용 sqlcmd, SSMS 또는 기타 SQL 도구) |
sqlcmd 유틸리티 SQL Server Management Studio |
새 자동화 및 관리 시나리오의 경우 Azure CLI(az), Azure CLI 확장 및 Azure Arc Portal 환경을 선호합니다.
다음 문서에서는 azdata 도구의 sql 명령에 대한 참조를 제공합니다. 다른 azdata 명령에 대한 자세한 내용은 azdata 참조를 참조하세요.
명령어
| Command | 설명 |
|---|---|
| azdata arc | Azure 데이터 서비스에 Azure Arc를 사용하기 위한 명령입니다. |
| azdata sql | SQL DB CLI를 사용하면 사용자가 T-SQL을 통해 SQL Server와 상호 작용할 수 있습니다. |
| azdata login | 클러스터의 컨트롤러 엔드포인트에 로그인하고 네임스페이스를 활성 컨텍스트로 설정합니다. 로그인 시 암호를 사용하려면 AZDATA_PASSWORD 환경 변수를 설정해야 합니다. |
| azdata logout | 클러스터에서 로그아웃합니다. |
| azdata context | 컨텍스트 관리 명령. |
| azdata bdc | SQL Server 빅 데이터 클러스터를 선택, 관리 및 운영합니다. |
| azdata extension | CLI 확장을 관리하고 업데이트합니다. |
| azdata app | 애플리케이션을 만들고, 삭제하고, 실행하고, 관리합니다. |
| azdata postgres | Postgres 쿼리 실행기 및 대화형 셸입니다. |
| azdata Notebook | 터미널에서 Notebook 보기, 실행 및 관리를 위한 명령입니다. |
azdata login
클러스터가 배포되면 배포 중에 컨트롤러 엔드포인트가 나열되므로 로그인하는 데 사용해야 합니다. 컨트롤러 엔드포인트를 모르는 경우 클러스터의 kube 구성을 사용자 home>/.kube/config의 <기본 위치에 시스템에 배치하여 로그인하거나 KUBECONFIG env var(예: EXPORT KUBECONFIG=path/to/.kube/config)을 사용할 수 있습니다. 로그인하면 이 클러스터의 네임스페이스가 활성 컨텍스트로 설정됩니다.
azdata login [--auth]
[--endpoint -e]
[--accept-eula -a]
[--namespace -ns]
[--username -u]
[--principal -p]
예제
기본 인증을 사용하여 로그인합니다.
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
명시적 보안 주체와 함께 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 구성을 사용자 home>/.kube/config의 <기본 위치에 두거나 KUBECONFIG env var(예: EXPORT KUBECONFIG=path/to/.kube/config)을 사용하세요.
azdata login --namespace ClusterName --username johndoe@contoso.com --endpoint https://<ip or domain name>:30080 --accept-eula yes
컴퓨터에서 kube 구성을 사용하여 로그인하고 AZDATA_USERNAME, AZDATA_PASSWORD 및 ACCEPT_EULA 대해 var 집합을 env합니다.
azdata login -n ClusterName
선택적 매개 변수
--auth
인증 전략입니다. 기본 또는 Active Directory 인증입니다. 기본값은 "기본" 인증입니다.
--endpoint -e
클러스터 컨트롤러 엔드포인트 "https://host:port". 이 인수를 사용하지 않으려면 컴퓨터에서 kube 구성을 사용할 수 있습니다. 구성이 사용자 home>/.kube/config의 <기본 위치에 있는지 확인하거나 KUBECONFIG env var을 사용하세요.
--accept-eula -a
사용 조건에 동의합니까? [예/아니요]. 이 인수를 사용하지 않으려면 환경 변수 ACCEPT_EULA '예'로 설정할 수 있습니다. 이 제품의 사용 조건은 .에서 https://aka.ms/eula-azdata-en볼 수 있습니다.
--namespace -ns
클러스터 컨트롤 플레인의 네임스페이스입니다.
--username -u
계정 사용자입니다. 이 인수를 사용하지 않으려면 환경 변수를 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
예제
이 사용자를 로그아웃합니다.
azdata logout
전역 인수
--debug
로깅 수위를 높여 모든 디버그 로그를 표시합니다.
--help -h
이 도움말 메시지를 표시하고 종료합니다.
--output -o
출력 형식 허용되는 값: json, jsonc, table, tsv 기본값: json
--query -q
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.
--verbose
로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.
다음 단계
다른 azdata 명령에 대한 자세한 내용은 azdata 참조를 참조하세요.
azdata 도구를 설치하는 방법에 대한 자세한 내용은 azdata 설치를 참조하세요.