az synapse workspace

Synapse 작업 영역을 관리합니다.

명령

az synapse workspace activate

작업 영역을 활성화하고 작업 영역을 처음 프로비전하고 이중 암호화를 사용하도록 설정할 때 해당 상태를 보류 중에서 성공 상태로 변경합니다.

az synapse workspace check-name

Synapse 작업 영역 이름을 사용할 수 있는지 확인합니다.

az synapse workspace create

Synapse 작업 영역을 만듭니다.

az synapse workspace delete

Synapse 작업 영역을 삭제합니다.

az synapse workspace firewall-rule

작업 영역의 방화벽 규칙을 관리합니다.

az synapse workspace firewall-rule create

방화벽 규칙을 만듭니다.

az synapse workspace firewall-rule delete

방화벽 규칙을 삭제합니다.

az synapse workspace firewall-rule list

모든 방화벽 규칙을 나열합니다.

az synapse workspace firewall-rule show

방화벽 규칙을 가져옵니다.

az synapse workspace firewall-rule update

방화벽 규칙을 업데이트합니다.

az synapse workspace firewall-rule wait

방화벽 규칙의 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

az synapse workspace key

작업 영역의 키를 관리합니다.

az synapse workspace key create

작업 영역의 키를 만듭니다.

az synapse workspace key delete

작업 영역의 키를 삭제합니다. 활성 상태의 키를 삭제할 수 없습니다.

az synapse workspace key list

지정된 작업 영역 아래의 키를 나열합니다.

az synapse workspace key show

작업 영역의 키를 이름으로 표시합니다.

az synapse workspace key wait

작업 영역 키의 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

az synapse workspace list

모든 Synapse 작업 영역을 나열합니다.

az synapse workspace managed-identity

작업 영역의 관리 ID를 관리합니다.

az synapse workspace managed-identity grant-sql-access

관리 ID에 작업 영역의 sql 액세스 권한을 부여합니다.

az synapse workspace managed-identity revoke-sql-access

관리 ID에 대한 작업 영역의 sql 액세스를 취소합니다.

az synapse workspace managed-identity show-sql-access

관리 ID에 작업 영역의 sql 액세스 상태를 표시합니다.

az synapse workspace managed-identity wait

관리 ID에 대한 sql 액세스 상태 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

az synapse workspace show

Synapse 작업 영역을 가져옵니다.

az synapse workspace update

Synapse 작업 영역을 업데이트합니다.

az synapse workspace wait

작업 영역의 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

az synapse workspace activate

작업 영역을 활성화하고 작업 영역을 처음 프로비전하고 이중 암호화를 사용하도록 설정할 때 해당 상태를 보류 중에서 성공 상태로 변경합니다.

Azure Synapse Analytics 작업 영역을 만들 때 작업 영역에 이중 암호화를 제공하는 고객 관리형 키를 사용하여 작업 영역의 미사용 데이터를 모두 암호화하도록 선택할 수 있습니다. 제거 보호가 사용하도록 설정된 키 자격 증명 모음을 만들고 키 자격 증명 모음에 대한 액세스 정책을 지정하는 등 암호화 환경을 먼저 설정해야 할 수 있습니다. 그런 다음 이 cmdlet을 사용하여 고객 관리형 키를 사용하여 이중 암호화가 사용하도록 설정된 새 Azure Synapse Analytics 작업 영역을 활성화합니다.

az synapse workspace activate --key-identifier
                              [--ids]
                              [--name]
                              [--no-wait]
                              [--resource-group]
                              [--workspace-name]

예제

작업 영역을 활성화합니다.

az synapse workspace activate --name newkey --workspace-name testsynapseworkspace \
--resource-group rg --key-identifier https://{keyvaultname}.vault.azure.net/keys/{keyname}

필수 매개 변수

--key-identifier

작업 영역 암호화 키의 Key Vault URL입니다. 는 https://{keyvaultname}.vault.azure.net/keys/{keyname}의 형식이어야 합니다.

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

작업 영역 고객 관리형 키 표시 이름입니다. 모든 기존 키는 /"az synapse workspace key list/" cmdlet을 사용하여 찾을 수 있습니다.

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--workspace-name

작업 영역 이름입니다.

az synapse workspace check-name

Synapse 작업 영역 이름을 사용할 수 있는지 확인합니다.

az synapse workspace check-name --name

예제

Synapse 작업 영역 이름을 사용할 수 있는지 확인합니다.

az synapse workspace check-name --name testsynapseworkspace

필수 매개 변수

--name -n

확인하려는 이름입니다.

az synapse workspace create

Synapse 작업 영역을 만듭니다.

az synapse workspace create --file-system
                            --name
                            --resource-group
                            --sql-admin-login-password
                            --sql-admin-login-user
                            --storage-account
                            [--account-name]
                            [--allowed-tenant-ids]
                            [--cmk]
                            [--collaboration-branch]
                            [--enable-managed-virtual-network {false, true}]
                            [--host-name]
                            [--key-name]
                            [--last-commit-id]
                            [--location]
                            [--no-wait]
                            [--prevent-data-exfiltration {false, true}]
                            [--project-name]
                            [--repository-name]
                            [--repository-type {AzureDevOpsGit, GitHub}]
                            [--root-folder]
                            [--tags]
                            [--tenant-id]

예제

Synapse 작업 영역 만들기

az synapse workspace create --name testworkspace --resource-group rg \
  --storage-account testadlsgen2 --file-system testfilesystem \
  --sql-admin-login-user cliuser1 --sql-admin-login-password Password123! --location "East US"

스토리지 리소스 ID를 사용하여 Synapse 작업 영역 만들기

az synapse workspace create --name testworkspace --resource-group rg \
  --storage-account /subscriptions/00000000-0000-0000-0000-000000000000/resourceGroups/rg/providers/Microsoft.Storage/storageAccounts/testadlsgen2 --file-system testfilesystem \
  --sql-admin-login-user cliuser1 --sql-admin-login-password Password123! --location "East US"

고객 관리형 키를 사용하여 Synapse 작업 영역 만들기

az synapse workspace create --name testworkspace --resource-group rg \
  --storage-account testadlsgen2 --file-system testfilesystem \
  --sql-admin-login-user cliuser1 --sql-admin-login-password Password123! --location "East US" \
  --key-identifier https://{keyvaultname}.vault.azure.net/keys/{keyname} --key-name testcmk

Azure devops에 연결하는 Synapse 작업 영역 만들기

az synapse workspace create --name testworkspace --resource-group rg \
  --storage-account testadlsgen2 --file-system testfilesystem \
  --sql-admin-login-user cliuser1 --sql-admin-login-password Password123! --location "East US" \
  --repository-type AzureDevOpsGit --account-name testuser --project-name testprj \
  --repository-name testrepo --collaboration-branch main --last-commit-id 000000

필수 매개 변수

--file-system

데이터 레이크 스토리지 계정의 파일 시스템입니다.

--name -n

작업 영역 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--sql-admin-login-password -p

sql 관리자 로그인 암호입니다.

--sql-admin-login-user -u

sql 관리자 로그인 사용자 이름입니다.

--storage-account

Data Lake Storage 계정 이름 또는 리소스 ID입니다.

선택적 매개 변수

--account-name

리포지토리 또는 Azure devops 조직 이름에 사용되는 GitHub 계정 이름입니다.

--allowed-tenant-ids

아웃바운드 데이터 트래픽이 허용된 승인된 Azure AD 테넌트입니다. 현재 사용자의 Azure AD 테넌트는 기본적으로 포함됩니다. (PowerShell에서')를 사용하여 허용되는 모든 테넌트 ID를 사용하지 않도록 설정합니다.

--cmk --key-identifier

작업 영역의 미사용 데이터를 모두 암호화하는 데 사용되는 고객 관리형 키입니다. 키 식별자는 https://{keyvaultname}.vault.azure.net/keys/{keyname}의 형식이어야 합니다.

--collaboration-branch

다른 사용자와 공동 작업하고 게시할 분기 이름입니다.

--enable-managed-virtual-network --enable-managed-vnet

플래그는 관리형 가상 네트워크를 사용하도록 설정할지 여부를 나타냅니다.

허용되는 값: false, true
--host-name

github Enterprise Server를 사용하는 경우 GitHub Enterprise Cloud에서 이 옵션을 사용하지 않는 것과 같은 https://github.mydomain.com.Do 심각도 URL을 제공합니다.

--key-name

작업 영역 고객 관리형 키 표시 이름입니다. 모든 기존 키는 "az synapse workspace key list" cmdlet을 사용하여 찾을 수 있습니다.

기본값: default
--last-commit-id

마지막 커밋 ID입니다.

--location -l

위치입니다. 값 출처: az account list-locations. az configure --defaults location=<location>을 사용하여 기본 위치를 구성할 수 있습니다.

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--prevent-data-exfiltration --prevent-exfiltration

플래그는 데이터 반출을 사용할지 여부를 나타냅니다.

허용되는 값: false, true
--project-name

연결할 프로젝트 이름입니다.

--repository-name

연결하려는 리포지토리의 이름입니다.

--repository-type

리포지토리 구성 유형입니다.

허용되는 값: AzureDevOpsGit, GitHub
--root-folder

Azure synapse JSON 리소스의 위치에 대한 폴더 이름을 가져옵니다. 기본값은 /입니다.

기본값: /
--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--tenant-id

Azure devops를 연결하는 데 사용되는 테넌트 ID입니다.

az synapse workspace delete

Synapse 작업 영역을 삭제합니다.

az synapse workspace delete [--ids]
                            [--name]
                            [--no-wait]
                            [--resource-group]
                            [--yes]

예제

Synapse 작업 영역을 삭제합니다.

az synapse workspace delete --name testsynapseworkspace --resource-group rg

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. '리소스 ID' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

작업 영역 이름입니다.

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--yes -y

확인을 묻는 메시지를 표시하지 마세요.

az synapse workspace list

모든 Synapse 작업 영역을 나열합니다.

az synapse workspace list [--resource-group]

예제

구독에서 모든 Synapse 작업 영역 나열

az synapse workspace list

특정 리소스 그룹 아래에 모든 Synapse 작업 영역 나열

az synapse workspace list --resource-group rg

선택적 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az synapse workspace show

Synapse 작업 영역을 가져옵니다.

az synapse workspace show [--ids]
                          [--name]
                          [--resource-group]

예제

Synapse 작업 영역을 가져옵니다.

az synapse workspace show --name testsynapseworkspace --resource-group rg

선택적 매개 변수

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. 'Resource Id' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--name -n

작업 영역 이름입니다.

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

az synapse workspace update

Synapse 작업 영역을 업데이트합니다.

az synapse workspace update [--account-name]
                            [--allowed-tenant-ids]
                            [--collaboration-branch]
                            [--host-name]
                            [--ids]
                            [--key-name]
                            [--last-commit-id]
                            [--name]
                            [--no-wait]
                            [--project-name]
                            [--repository-name]
                            [--repository-type {AzureDevOpsGit, GitHub}]
                            [--resource-group]
                            [--root-folder]
                            [--sql-admin-login-password]
                            [--tags]
                            [--tenant-id]

예제

Synapse 작업 영역 업데이트

az synapse workspace update --name fromcli4 --resource-group rg \
  --tags key1=value1

선택적 매개 변수

--account-name

리포지토리 또는 Azure devops 조직 이름에 사용되는 GitHub 계정 이름입니다.

--allowed-tenant-ids

승인된 Azure AD 아웃바운드 데이터 트래픽이 허용된 테넌트입니다. 현재 사용자의 Azure AD 테넌트는 기본적으로 포함됩니다. PowerShell에서 ('')를 사용하여 허용되는 모든 테넌트 ID를 사용하지 않도록 설정합니다.

--collaboration-branch

다른 사용자와 공동 작업하고 게시할 분기 이름입니다.

--host-name

github Enterprise Server를 사용하는 경우 GitHub Enterprise Cloud에서 이 옵션을 사용하지 않는 것과 같은 https://github.mydomain.com.Do 심각도 URL을 제공합니다.

--ids

하나 이상의 리소스 ID(공백으로 구분)입니다. 'Resource Id' 인수의 모든 정보를 포함하는 전체 리소스 ID여야 합니다. --ids 또는 다른 '리소스 ID' 인수를 제공해야 합니다.

--key-name

작업 영역 고객 관리형 키 표시 이름입니다. 모든 기존 키는 "az synapse workspace key list" cmdlet을 사용하여 찾을 수 있습니다.

--last-commit-id

마지막 커밋 ID입니다.

--name -n

작업 영역 이름입니다.

--no-wait

장기 실행 작업이 완료될 때까지 기다리지 마세요.

--project-name

연결할 프로젝트 이름입니다.

--repository-name

연결할 리포지토리의 이름입니다.

--repository-type

리포지토리 구성 유형입니다.

허용되는 값: AzureDevOpsGit, GitHub
--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--root-folder

Azure synapse JSON 리소스의 위치에 대한 폴더의 이름을 가져옵니다. 기본값은 /입니다.

--sql-admin-login-password -p

sql 관리자 로그인 암호입니다.

--tags

공백으로 구분된 태그: key[=value] [key[=value] ...]. ""를 사용하여 기존 태그를 지웁니다.

--tenant-id

Azure devops를 연결하는 데 사용되는 테넌트 ID입니다.

az synapse workspace wait

작업 영역의 조건이 충족될 때까지 CLI를 대기 상태로 설정합니다.

az synapse workspace wait --resource-group
                          --workspace-name
                          [--created]
                          [--custom]
                          [--deleted]
                          [--exists]
                          [--interval]
                          [--timeout]
                          [--updated]

필수 매개 변수

--resource-group -g

리소스 그룹의 이름입니다. az configure --defaults group=<name>을 사용하여 기본 그룹을 구성할 수 있습니다.

--workspace-name

작업 영역의 이름

선택적 매개 변수

--created

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

--custom

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

--deleted

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

--exists

리소스가 있을 때까지 기다립니다.

--interval

폴링 간격(초)입니다.

기본값: 30
--timeout

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

기본값: 3600
--updated

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