적용 대상:
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 sql shell | SQL CLI를 사용하면 사용자가 T-SQL을 통해 SQL Server 및 Azure SQL과 상호 작용할 수 있습니다. |
| azdata sql query | SQL CLI를 사용하면 사용자가 T-SQL을 통해 SQL Server 및 Azure SQL과 상호 작용할 수 있습니다. |
azdata sql shell
SQL CLI를 사용하면 사용자가 T-SQL을 통해 SQL Server 및 Azure SQL과 상호 작용할 수 있습니다.
azdata sql shell [--username -u]
[--database -d]
[--server -s]
[--integrated -e]
[--mssqlclirc]
[--row-limit]
[--less-chatty]
[--auto-vertical-output]
[--encrypt -n]
[--trust-server-certificate -c]
[--connect-timeout -l]
[--application-intent -k]
[--multi-subnet-failover -m]
[--packet-size]
[--dac-connection -a]
[--input-file -i]
[--output-file]
[--enable-sqltoolsservice-logging]
[--prompt]
예제
대화형 환경을 시작하는 예제 명령줄입니다.
azdata sql shell
제공된 서버, 사용자 및 데이터베이스를 사용하는 예제 명령줄
azdata sql shell --server localhost --username sa --database master
선택적 매개 변수
--username -u
데이터베이스에 연결할 사용자 이름입니다.
--database -d
연결할 데이터베이스 이름입니다.
--server -s
SQL Server 인스턴스 이름 또는 주소입니다.
--integrated -e
Windows에서 통합 인증을 사용합니다.
--mssqlclirc
mssqlclirc 구성 파일의 위치입니다.
--row-limit
행 제한 프롬프트에 대한 임계값을 설정합니다. 0을 사용하여 프롬프트를 사용하지 않도록 설정합니다.
--less-chatty
시작 시 소개를 건너뛰고 종료 시 작별인사를 합니다.
--auto-vertical-output
결과가 터미널 너비보다 넓은 경우 자동으로 세로 출력 모드로 전환합니다.
--encrypt -n
서버에 인증서가 설치된 경우 SQL Server는 모든 데이터에 SSL 암호화를 사용합니다.
--trust-server-certificate -c
신뢰의 유효성을 검사하기 위해 인증서 체인을 건너뛰는 동안 채널이 암호화됩니다.
--connect-timeout -l
요청을 종료하기 전에 서버에 대한 연결을 기다리는 시간(초)입니다.
--application-intent -k
SQL Server 가용성 그룹의 데이터베이스에 연결할 때 애플리케이션 워크로드 유형을 선언합니다.
--multi-subnet-failover -m
애플리케이션이 다른 서브넷의 Always On AG에 연결하는 경우 이를 설정하면 현재 활성 서버에 대한 검색 및 연결 속도가 빨라집니다.
--packet-size
SQL Server와 통신하는 데 사용되는 네트워크 패킷의 크기(바이트)입니다.
--dac-connection -a
전용 관리자 연결을 사용하여 SQL Server에 연결합니다.
--input-file -i
처리를 위해 SQL 문의 일괄 처리가 포함된 파일을 지정합니다.
--output-file
쿼리에서 출력을 받는 파일을 지정합니다.
--enable-sqltoolsservice-logging
SqlToolsService에 대한 진단 로깅을 사용하도록 설정합니다.
--prompt
프롬프트 형식(기본값: \d>
전역 인수
--debug
로깅 수위를 높여 모든 디버그 로그를 표시합니다.
--help -h
이 도움말 메시지를 표시하고 종료합니다.
--output -o
출력 형식 허용되는 값: json, jsonc, table, tsv 기본값: json
--query -q
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.
--verbose
로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.
azdata sql query
SQL CLI를 사용하면 사용자가 T-SQL을 통해 SQL Server 및 Azure SQL과 상호 작용할 수 있습니다.
azdata sql query -q
[--database -d]
[--username -u]
[--server -s]
[--integrated -e]
예제
테이블 이름 목록을 선택하는 예제 명령줄입니다.
azdata sql query --server localhost --username sa --database master -q "SELECT name FROM SYS.TABLES"
필수 매개 변수
-q
실행할 T-SQL 쿼리입니다.
선택적 매개 변수
--database -d
연결할 데이터베이스 이름입니다.
master
--username -u
데이터베이스에 연결할 사용자 이름입니다.
--server -s
SQL Server 인스턴스 이름 또는 주소입니다.
--integrated -e
Windows에서 통합 인증을 사용합니다.
전역 인수
--debug
로깅 수위를 높여 모든 디버그 로그를 표시합니다.
--help -h
이 도움말 메시지를 표시하고 종료합니다.
--output -o
출력 형식 허용되는 값: json, jsonc, table, tsv 기본값: json
--query -q
JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.
--verbose
로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.
다음 단계
다른 azdata 명령에 대한 자세한 내용은 azdata 참조를 참조하세요.
azdata 도구를 설치하는 방법에 대한 자세한 내용은 azdata 설치를 참조하세요.