az synapse sql-script

synapse 작업 영역에서 SQL 스크립트를 관리합니다.

명령

Name	Description	형식	상태
az synapse sql-script create	SQL 스크립트를 만들거나 업데이트합니다.	Core	GA
az synapse sql-script delete	SQL 스크립트를 삭제합니다.	Core	GA
az synapse sql-script export	SQL 스크립트를 내보냅니다.	Core	GA
az synapse sql-script import	SQL 스크립트를 가져옵니다.	Core	GA
az synapse sql-script list	Synapse 작업 영역에 SQL 스크립트를 나열합니다.	Core	GA
az synapse sql-script show	SQL 스크립트를 가져옵니다.	Core	GA
az synapse sql-script wait	SQL 스크립트의 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.	Core	GA

az synapse sql-script create

SQL 스크립트를 만들거나 업데이트합니다.

az synapse sql-script create --file
                             --name
                             --workspace-name
                             [--additional-properties]
                             [--description]
                             [--folder-name]
                             [--no-wait]
                             [--result-limit {-1, 5000}]
                             [--sql-database-name]
                             [--sql-pool-name]

예제

SQL 스크립트를 만듭니다.

az synapse sql-script create --workspace-name testsynapseworkspace \
  --name testsqlscriptname \
  --file 'path/test.sql'

필수 매개 변수

--file -f

SQL 쿼리 파일 경로입니다.

--name -n

SQL 스크립트 이름입니다.

--workspace-name

작업 영역 이름입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--additional-properties

SQL 스크립트 추가 속성입니다.

--description

SQL 스크립트 설명입니다.

--folder-name

이 SQL 스크립트가 있는 폴더입니다. 지정하지 않으면 이 SQL 스크립트가 루트 수준에 표시됩니다. 예: folder/subfolder1.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

속성	값
Default value:	False

--result-limit

SQL 쿼리 결과 제한입니다. 기본값은 5000입니다. '-1'은 제한이 없습니다.

속성	값
Default value:	5000
허용되는 값:	-1, 5000

--sql-database-name

SQL 데이터베이스 이름입니다.

--sql-pool-name

SQL 풀 이름입니다.

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az synapse sql-script delete

SQL 스크립트를 삭제합니다.

az synapse sql-script delete --name
                             --workspace-name
                             [--no-wait]

예제

SQL 스크립트를 삭제합니다.

az synapse sql-script delete --workspace-name testsynapseworkspace \
  --name testsqlscriptname

필수 매개 변수

--name -n

SQL 스크립트 이름입니다.

--workspace-name

작업 영역 이름입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

속성	값
Default value:	False

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az synapse sql-script export

SQL 스크립트를 내보냅니다.

az synapse sql-script export --output-folder
                             --workspace-name
                             [--name]

예제

SQL 스크립트를 내보냅니다.

az synapse sql-script export --workspace-name testsynapseworkspace \
  --name testsqlscriptname \
  --output-folder 'path/folder'

필수 매개 변수

--output-folder

SQL 스크립트 내보내기 경로입니다.

--workspace-name

작업 영역 이름입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--name -n

SQL 스크립트 이름입니다.

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az synapse sql-script import

SQL 스크립트를 가져옵니다.

az synapse sql-script import --file
                             --name
                             --workspace-name
                             [--additional-properties]
                             [--description]
                             [--folder-name]
                             [--no-wait]
                             [--result-limit {-1, 5000}]
                             [--sql-database-name]
                             [--sql-pool-name]

예제

SQL 스크립트를 가져옵니다.

az synapse sql-script import --workspace-name testsynapseworkspace \
  --name testsqlscriptname \
  --file 'path/test.sql'

필수 매개 변수

--file -f

SQL 쿼리 파일 경로입니다.

--name -n

SQL 스크립트 이름입니다.

--workspace-name

작업 영역 이름입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--additional-properties

SQL 스크립트 추가 속성입니다.

--description

SQL 스크립트 설명입니다.

--folder-name

이 SQL 스크립트가 있는 폴더입니다. 지정하지 않으면 이 SQL 스크립트가 루트 수준에 표시됩니다. 예: folder/subfolder1.

--no-wait

장기 실행 작업이 완료되기를 기다리지 마세요.

속성	값
Default value:	False

--result-limit

SQL 쿼리 결과 제한입니다. 기본값은 5000입니다. '-1'은 제한이 없습니다.

속성	값
Default value:	5000
허용되는 값:	-1, 5000

--sql-database-name

SQL 데이터베이스 이름입니다.

--sql-pool-name

SQL 풀 이름입니다.

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az synapse sql-script list

Synapse 작업 영역에 SQL 스크립트를 나열합니다.

az synapse sql-script list --workspace-name

예제

SQL 스크립트를 나열합니다.

az synapse sql-script list --workspace-name testsynapseworkspace

필수 매개 변수

--workspace-name

작업 영역 이름입니다.

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az synapse sql-script show

SQL 스크립트를 가져옵니다.

az synapse sql-script show --name
                           --workspace-name

예제

SQL 스크립트를 가져옵니다.

az synapse sql-script show --workspace-name testsynapseworkspace \
  --name testsqlscriptname

필수 매개 변수

--name -n

SQL 스크립트 이름입니다.

--workspace-name

작업 영역 이름입니다.

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False

az synapse sql-script wait

SQL 스크립트의 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

az synapse sql-script wait --name
                           --workspace-name
                           [--created]
                           [--custom]
                           [--deleted]
                           [--exists]
                           [--interval]
                           [--timeout]
                           [--updated]

필수 매개 변수

--name -n

SQL 스크립트 이름입니다.

--workspace-name

작업 영역 이름입니다.

선택적 매개 변수

다음 매개 변수는 선택 사항이지만 컨텍스트에 따라 명령이 성공적으로 실행되려면 하나 이상의 매개 변수가 필요할 수 있습니다.

--created

'Succeeded'에서 'provisioningState'를 사용하여 생성될 때까지 기다립니다.

속성	값
매개 변수 그룹:	Wait Condition Arguments
Default value:	False

--custom

조건이 사용자 지정 JMESPath 쿼리를 충족할 때까지 기다립니다. 예: provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

속성	값
매개 변수 그룹:	Wait Condition Arguments

--deleted

삭제될 때까지 기다립니다.

속성	값
매개 변수 그룹:	Wait Condition Arguments
Default value:	False

--exists

리소스가 존재할 때까지 기다립니다.

속성	값
매개 변수 그룹:	Wait Condition Arguments
Default value:	False

--interval

폴링 간격(초)입니다.

속성	값
매개 변수 그룹:	Wait Condition Arguments
Default value:	30

--timeout

최대 대기 시간(초)입니다.

속성	값
매개 변수 그룹:	Wait Condition Arguments
Default value:	3600

--updated

'Succeeded'에서 provisioningState로 업데이트될 때까지 기다립니다.

속성	값
매개 변수 그룹:	Wait Condition Arguments
Default value:	False

전역 매개 변수

--debug

로깅 수위를 높여 모든 디버그 로그를 표시합니다.

속성	값
Default value:	False

--help -h

이 도움말 메시지를 표시하고 종료합니다.

--only-show-errors

경고를 표시하지 않고 오류만 표시합니다.

속성	값
Default value:	False

--output -o

출력 형식

속성	값
Default value:	json
허용되는 값:	json, jsonc, none, table, tsv, yaml, yamlc

--query

JMESPath 쿼리 문자열입니다. 자세한 내용 및 예제는 http://jmespath.org/ 참조하세요.

--subscription

구독의 이름 또는 ID입니다. az account set -s NAME_OR_ID사용하여 기본 구독을 구성할 수 있습니다.

--verbose

로깅의 자세한 정도를 증가시킵니다. 전체 디버그 로그에 --debug를 사용합니다.

속성	값
Default value:	False