Azure Data Studio 명령줄 인터페이스
Azure Data Studio에는 애플리케이션을 시작하는 방법을 제어할 수 있는 기본 제공 명령줄 인터페이스가 포함되어 있습니다. 명령줄 옵션(스위치)을 통해 파일을 열고, 확장을 설치하고, 표시 언어를 변경하고, 진단을 출력할 수 있습니다.
Azure Data Studio 내에서 명령줄 도구를 실행하는 방법의 예는 통합 터미널을 참조 하세요.
참고 항목
Microsoft Entra ID는 Azure AD(Azure Active Directory)의 새 이름이지만, 기존 환경의 중단을 방지하기 위해 UI 필드, 연결 공급자, 오류 코드 및 cmdlet과 같은 일부 하드 코딩된 요소에는 여전히 Azure AD가 남아 있습니다. 이 문서에서는 두 이름을 혼용할 수 있습니다.
명령줄 도움말
Azure Data Studio 명령줄 인터페이스의 개요를 보려면 Azure Data Studio(터미널 보기 > ) 또는 명령 프롬프트 내에서 터미널을 열고 입력 azuredatastudio --help합니다. 출력에는 잘린 예제와 같이 버전, 사용 예제 및 명령줄 옵션 목록이 포함됩니다.
Azure Data Studio 1.48.1
Usage: azuredatastudio.exe [options][paths...]
To read output from another program, append '-' (e.g. 'echo Hello World | azuredatastudio.exe -')
Options
<vscode options>
-h --help Print usage.
--aad Use Azure Active Directory authentication, this option is
deprecated - use 'authenticationType' instead.
-A --applicationName Supports providing applicationName
that will be used for connection profile app name.
-T --authenticationType Provide authentication mode to be
used. Accepted values: AzureMFA, SqlLogin, Integrated, etc.
-c --command <command-name> Name of command to run, accepted
values: connect, openConnectionDialog
-Z --connectionProperties Supports providing advanced connection properties that
providers support. Value must be a json object containing
key-value pairs in format: '{"key1":"value1"}'
-D --database <database> Name of database
-E --integrated Use Integrated authentication,
this option is deprecated - use 'authenticationType' instead.
-P --provider Connection provider to use, e.g. MSSQL, PGSQL, etc.
-S --server <server> Name of target server or host name.
--showDashboard Whether or not to show dashboard on connection, false by default.
-U --user <user-name> User name/email address
명령줄에서 시작
명령줄에서 Azure Data Studio를 시작하여 파일, 폴더 또는 프로젝트를 빠르게 열 수 있습니다. 일반적으로 폴더의 컨텍스트 내에서 Azure Data Studio를 엽니다. 열린 터미널 또는 명령 프롬프트에서 프로젝트 폴더로 이동하여 .를 입력 azuredatastudio합니다.
쿼리 편집기 사용하여 시작
Azure Data Studio를 열 때 쿼리 편집기 스크립트를 여는 경우가 있습니다. 파일의 경로를 제공하여 기존 스크립트로 Azure Data Studio를 시작할 수 있습니다.
azuredatastudio .\samplescript.sql
URI를 사용하여 시작
URL 형식을 사용하여 브라우저에서 Azure Data Studio를 시작하여 시작할 때 신속하게 연결을 설정하거나 연결 대화 상자를 열고 필요에 따라 쿼리 편집기 스크립트를 열 수 있습니다. URI를 사용하여 시작하는 데 지원되는 형식은 다음과 같습니다.
azuredatastudio://{command}?{option1}={value1}&{option2}={value2}...
지원되는 명령
명령줄에서 Azure Data Studio를 시작할 때 지원되는 명령은 다음과 같습니다.
connect: 제공된 옵션을 사용하여 대상 서버에 연결합니다.openConnectionDialog: 제공된 옵션을 사용하여 연결 대화 상자를 엽니다.
지원되는 옵션
URL에서 다음 옵션을 제공할 수 있습니다.
| 옵션 | 설명 |
|---|---|
provider |
MSSQL, PGSQL 등과 같이 사용할 연결 공급자입니다. |
server |
대상 서버 또는 호스트 이름의 이름입니다. |
database |
데이터베이스의 이름입니다. |
user |
사용자의 이름입니다. |
authenticationType |
사용할 인증 모드, 허용되는 값: AzureMFA, SqlLogin, Integrated등 |
applicationName |
연결 프로필에 사용되는 애플리케이션 이름을 제공합니다. |
connectionProperties |
공급자가 지원하는 고급 연결 속성입니다. 값은 형식 {"key1":"value1"}의 키-값 쌍을 포함하는 json 개체여야 합니다. |
예제
명령 프롬프트: 통합 인증
azuredatastudio --server localhost --authenticationType Integrated
"서버 인증서 신뢰" 경고가 표시될 수 있습니다.
참고 항목
Virtual Machine에서 온-프레미스 SQL Server 또는 SQL Server에 연결하는 사용자의 경우 암호화된 연결을 지원하도록 데이터베이스 엔진 구성해야 합니다. 전체 지침은 연결 암호화를 위한 SQL Server 데이터베이스 엔진 구성을 참조하세요.
명령 프롬프트: 저장된 스크립트를 사용하여 Azure Data Studio 시작
azuredatastudio --server localhost --provider mssql --user sa .\samplescript.sql
브라우저
azuredatastudio://connect?server=*****&user=*****&authenticationType=*****&connectionProperties={"key1":"value1"}