적용 대상: 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 bdc create | 빅 데이터 클러스터를 만듭니다. |
| azdata bdc delete | 빅 데이터 클러스터를 삭제합니다. |
| azdata bdc upgrade | SQL Server 빅 데이터 클러스터의 각 컨테이너에 배포된 이미지를 업데이트합니다. |
| azdata bdc config | 구성 명령. |
| azdata bdc 엔드포인트 | 엔드포인트 명령. |
| azdata bdc debug | 디버그 명령. |
| azdata bdc status | 빅 데이터 클러스터 상태 명령. |
| azdata bdc control | 서비스 명령을 제어합니다. |
| azdata bdc sql | Sql 서비스 명령. |
| azdata bdc hdfs | Hdfs 서비스 명령. |
| azdata bdc spark | Spark 서비스 명령. |
| azdata bdc gateway | 게이트웨이 서비스 명령. |
| azdata bdc app | App Service 명령. |
| azdata bdc hdfs | HDFS 모듈은 HDFS 파일 시스템에 액세스하는 명령을 제공합니다. |
| azdata bdc settings | 빅 데이터 클러스터 설정 명령. |
| azdata bdc spark | Spark 명령을 사용하면 사용자가 세션, 문 및 일괄 처리를 만들고 관리하여 Spark 시스템과 상호 작용할 수 있습니다. |
| azdata bdc rotate | 이 명령은 빅 데이터 클러스터에서 자동 생성된 AD 계정의 암호를 회전합니다. 자세한 내용은 AD 암호 회전 개요를 참조하세요. |
azdata bdc create
SQL Server 빅 데이터 클러스터 만들기 - 다음 환경 변수 ['AZDATA_USERNAME', 'AZDATA_PASSWORD']와 함께 시스템에 Kubernetes 구성이 필요합니다.
azdata bdc create [--name -n]
[--config-profile -c]
[--accept-eula -a]
[--node-label -l]
[--force -f]
예제
안내된 SQL Server 빅 데이터 클러스터 배포 환경 - 필요한 값에 대한 프롬프트가 표시됩니다.
azdata bdc create
를 통해 azdata bdc config init초기화된 인수 및 사용자 지정 구성 프로필을 사용하여 빅 데이터 클러스터 배포
azdata bdc create --accept-eula yes --config-profile ./path/to/config/profile
사용자 지정 클러스터 이름이 지정되고 기본 구성 프로필 aks-dev-test가 있는 빅 데이터 클러스터 배포
azdata bdc create --name <cluster_name> --accept-eula yes --config-profile aks-dev-test
인수가 있는 빅 데이터 클러스터 배포 - --force 플래그가 사용되므로 프롬프트가 제공되지 않습니다.
azdata bdc create --accept-eula yes --config-profile aks-dev-test --force
선택적 매개 변수
--name -n
kubernetes 네임스페이스에 사용되는 빅 데이터 클러스터 이름입니다.
--config-profile -c
클러스터 배포에 사용되는 빅 데이터 클러스터 구성 프로필: ['kubeadm-dev-test', 'kubeadm-prod', 'openshift-prod', 'aks-dev-test-ha', 'aks-dev-test', 'aro-dev-test', 'openshift-dev-test', 'aro-dev-test-ha']
--accept-eula -a
사용 조건에 동의합니까? [예/아니요]. 이 인수를 사용하지 않으려면 환경 변수 ACCEPT_EULA '예'로 설정할 수 있습니다. azdata에 대한 사용 조건은 .에서 https://aka.ms/eula-azdata-en볼 수 있습니다.
--node-label -l
배포할 노드를 지정하는 데 사용되는 빅 데이터 클러스터 노드 레이블입니다.
--force -f
강제로 만들면 사용자에게 값에 대한 메시지가 표시되지 않으며 모든 문제가 stderr의 일부로 인쇄됩니다.
전역 인수
--debug
로깅 수위를 높여 모든 디버그 로그를 표시합니다.
--help -h
이 도움말 메시지를 표시하고 종료합니다.
--output -o
출력 형식 허용되는 값: json, jsonc, table, tsv 기본값: json
--query -q
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.
--verbose
로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.
azdata bdc delete
SQL Server 빅 데이터 클러스터 삭제 - 시스템에 Kubernetes 구성이 필요합니다.
azdata bdc delete --name -n
[--force -f]
예제
빅 데이터 클러스터가 삭제됩니다.
azdata bdc delete --name <cluster_name>
필수 매개 변수
--name -n
kubernetes 네임스페이스에 사용되는 빅 데이터 클러스터 이름입니다.
선택적 매개 변수
--force -f
빅 데이터 클러스터를 강제로 삭제합니다.
전역 인수
--debug
로깅 수위를 높여 모든 디버그 로그를 표시합니다.
--help -h
이 도움말 메시지를 표시하고 종료합니다.
--output -o
출력 형식 허용되는 값: json, jsonc, table, tsv 기본값: json
--query -q
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.
--verbose
로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.
azdata bdc upgrade
SQL Server 빅 데이터 클러스터의 각 컨테이너에 배포된 이미지를 업데이트합니다. 업데이트된 이미지는 전달된 Docker 이미지를 기반으로 합니다. 업데이트된 이미지가 현재 배포된 이미지와 다른 Docker 이미지 리포지토리에서 가져온 경우 "리포지토리" 매개 변수도 필요합니다.
azdata bdc upgrade --name -n
--tag -t
[--repository -r]
[--controller-timeout -k]
[--stability-threshold -s]
[--component-timeout -p]
[--force -f]
예제
빅 데이터 클러스터는 동일한 리포지토리에서 새 이미지 태그 "cu2"로 업그레이드됩니다.
azdata bdc upgrade -t cu2
빅 데이터 클러스터는 새 리포지토리 "foo/bar/baz"에서 "cu2" 태그가 있는 새 이미지로 업그레이드합니다.
azdata bdc upgrade -t cu2 -r foo/bar/baz
빅 데이터 클러스터는 동일한 리포지토리에서 "cu2" 태그가 있는 새 이미지로 업그레이드합니다. 업그레이드는 컨트롤러가 업그레이드될 때까지 30분, 컨트롤러 db가 업그레이드될 때까지 30분 동안 대기합니다. 그런 다음, 나머지 클러스터를 업그레이드하지 않고 컨트롤러 및 컨트롤러 db가 3분 동안 실행될 때까지 기다립니다. 업그레이드의 각 후속 단계를 완료하는 데 40분이 걸립니다.
azdata bdc upgrade -t cu2 --controller-timeout=30 --component-timeout=40 --stability-threshold=3
필수 매개 변수
--name -n
kubernetes 네임스페이스에 사용되는 빅 데이터 클러스터 이름입니다.
--tag -t
클러스터의 모든 컨테이너를 업그레이드할 대상 Docker 이미지 태그입니다.
선택적 매개 변수
--repository -r
클러스터의 모든 컨테이너가 해당 이미지를 끌어오도록 하는 Docker 리포지토리입니다.
--controller-timeout -k
업그레이드를 롤백하기 전에 컨트롤러 또는 컨트롤러 데이터베이스가 업그레이드되기를 기다리는 시간(분)입니다.
--stability-threshold -s
안정적으로 표시하기 전에 업그레이드 후 대기할 시간(분)입니다.
--component-timeout -p
업그레이드를 일시 중지하기 전에 업그레이드의 각 단계(컨트롤러 업그레이드 후)가 완료되기를 기다리는 시간(분)입니다.
--force -f
있는 경우 업그레이드를 시작하기 전에 클러스터 상태 검사를 무시합니다.
전역 인수
--debug
로깅 수위를 높여 모든 디버그 로그를 표시합니다.
--help -h
이 도움말 메시지를 표시하고 종료합니다.
--output -o
출력 형식 허용되는 값: json, jsonc, table, tsv 기본값: json
--query -q
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.
--verbose
로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.
다음 단계
다른 azdata 명령에 대한 자세한 내용은 azdata 참조를 참조하세요.
azdata 도구를 설치하는 방법에 대한 자세한 내용은 azdata 설치를 참조하세요.