az synapse workspace

Zarządzanie obszarami roboczymi usługi Synapse.

Polecenia

az synapse workspace activate

Aktywuje obszar roboczy i zmienia stan oczekiwania na stan powodzenia po pierwszym aprowizacji obszaru roboczego i włączono podwójne szyfrowanie.

az synapse workspace check-name

Sprawdź, czy nazwa obszaru roboczego usługi Synapse jest dostępna, czy nie.

az synapse workspace create

Utwórz obszar roboczy usługi Synapse.

az synapse workspace delete

Usuń obszar roboczy usługi Synapse.

az synapse workspace firewall-rule

Zarządzanie regułami zapory obszaru roboczego.

az synapse workspace firewall-rule create

Utwórz regułę zapory.

az synapse workspace firewall-rule delete

Usuń regułę zapory.

az synapse workspace firewall-rule list

Wyświetl listę wszystkich reguł zapory.

az synapse workspace firewall-rule show

Uzyskiwanie reguły zapory.

az synapse workspace firewall-rule update

Zaktualizuj regułę zapory.

az synapse workspace firewall-rule wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku reguły zapory.

az synapse workspace key

Zarządzanie kluczami obszaru roboczego.

az synapse workspace key create

Utwórz klucz obszaru roboczego.

az synapse workspace key delete

Usuń klucz obszaru roboczego. Nie można usunąć klucza o aktywnym stanie.

az synapse workspace key list

Wyświetl listę kluczy w określonym obszarze roboczym.

az synapse workspace key show

Pokaż klucz obszaru roboczego według nazwy.

az synapse workspace key wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku klucza obszaru roboczego.

az synapse workspace list

Wyświetl listę wszystkich obszarów roboczych usługi Synapse.

az synapse workspace managed-identity

Zarządzanie tożsamością zarządzaną obszaru roboczego.

az synapse workspace managed-identity grant-sql-access

Udziel dostępu sql obszaru roboczego do tożsamości zarządzanej.

az synapse workspace managed-identity revoke-sql-access

Odwoływanie dostępu sql obszaru roboczego do tożsamości zarządzanej.

az synapse workspace managed-identity show-sql-access

Pokaż stan dostępu sql obszaru roboczego do tożsamości zarządzanej.

az synapse workspace managed-identity wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku stanu dostępu sql do tożsamości zarządzanej.

az synapse workspace show

Pobierz obszar roboczy usługi Synapse.

az synapse workspace update

Aktualizowanie obszaru roboczego usługi Synapse.

az synapse workspace wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku obszaru roboczego.

az synapse workspace activate

Aktywuje obszar roboczy i zmienia stan oczekiwania na stan powodzenia po pierwszym aprowizacji obszaru roboczego i włączono podwójne szyfrowanie.

Podczas tworzenia obszaru roboczego usługi Azure Synapse Analytics można szyfrować wszystkie dane magazynowane w obszarze roboczym przy użyciu klucza zarządzanego przez klienta, który zapewni podwójne szyfrowanie do obszaru roboczego. Najpierw może być konieczne skonfigurowanie środowiska szyfrowania, na przykład utworzenie magazynu kluczy z włączoną ochroną przeczyszczania i określenie zasad dostępu do magazynu kluczy. Następnie użyj tego polecenia cmdlet, aby aktywować nowy obszar roboczy usługi Azure Synapse Analytics, w którym włączono podwójne szyfrowanie przy użyciu klucza zarządzanego przez klienta.

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

Przykłady

aktywowanie obszaru roboczego.

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

Parametry wymagane

--key-identifier

Adres URL Key Vault klucza szyfrowania obszaru roboczego. powinna być w formacie: https://{keyvaultname}.vault.azure.net/keys/{keyname}.

Parametry opcjonalne

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacją). Powinien to być kompletny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa wyświetlana klucza zarządzanego przez klienta obszaru roboczego. Wszystkie istniejące klucze można znaleźć przy użyciu polecenia cmdlet /"az synapse workspace key list/".

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--workspace-name

Nazwa obszaru roboczego.

az synapse workspace check-name

Sprawdź, czy nazwa obszaru roboczego usługi Synapse jest dostępna, czy nie.

az synapse workspace check-name --name

Przykłady

Sprawdź, czy nazwa obszaru roboczego usługi Synapse jest dostępna, czy nie.

az synapse workspace check-name --name testsynapseworkspace

Parametry wymagane

--name -n

Nazwa, którą chcesz sprawdzić.

az synapse workspace create

Utwórz obszar roboczy usługi 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]
                            [--location]
                            [--no-wait]
                            [--prevent-data-exfiltration {false, true}]
                            [--project-name]
                            [--repository-name]
                            [--repository-type {AzureDevOpsGit, GitHub}]
                            [--root-folder]
                            [--tags]
                            [--tenant-id]

Przykłady

Tworzenie obszaru roboczego usługi 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"

Tworzenie obszaru roboczego usługi Synapse z identyfikatorem zasobu magazynu

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"

Tworzenie obszaru roboczego usługi Synapse przy użyciu klucza zarządzanego przez klienta

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

Tworzenie obszaru roboczego usługi Synapse łączącego się z usługą Azure DevOps

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

Parametry wymagane

--file-system

System plików konta usługi Data Lake Storage.

--name -n

Nazwa obszaru roboczego.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--sql-admin-login-password -p

Hasło logowania administratora sql.

--sql-admin-login-user -u

Nazwa użytkownika logowania administratora sql.

--storage-account

Nazwa konta usługi Data Lake Storage lub identyfikator zasobu.

Parametry opcjonalne

--account-name

GitHub nazwa konta używana dla repozytorium lub nazwy organizacji usługi Azure devops.

--allowed-tenant-ids

Zatwierdzone dzierżawy usługi Azure AD, do których dozwolony jest ruch wychodzący danych. Dzierżawa usługi Azure AD bieżącego użytkownika zostanie domyślnie dołączona. Użyj polecenia ('' w programie PowerShell), aby wyłączyć wszystkie dozwolone identyfikatory dzierżawy.

--cmk --key-identifier

Klucz zarządzany przez klienta używany do szyfrowania wszystkich danych magazynowanych w obszarze roboczym. Identyfikator klucza powinien być w formacie: https://{keyvaultname}.vault.azure.net/keys/{keyname}.

--collaboration-branch

Nazwa gałęzi, w której będziesz współpracować z innymi osobami i z których będziesz publikować.

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

Flaga wskazuje, czy włączyć zarządzaną sieć wirtualną.

akceptowane wartości: false, true
--host-name

W przypadku korzystania z usługi github Enterprise Server podaj adres URL serwera, tak aby https://github.mydomain.com.Do nie używać tej opcji z usługą GitHub Enterprise Cloud.

--key-name

Nazwa wyświetlana klucza zarządzanego przez klienta obszaru roboczego. Wszystkie istniejące klucze można znaleźć przy użyciu polecenia cmdlet "az synapse workspace key list".

wartość domyślna: default
--location -l

Lokalizacja. Wartości z: az account list-locations. Lokalizację domyślną można skonfigurować przy użyciu polecenia az configure --defaults location=<location>.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

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

Flaga wskazuje, czy włączyć eksfiltrację danych.

akceptowane wartości: false, true
--project-name

Nazwa projektu, z którym nawiązujesz połączenie.

--repository-name

Nazwa repozytorium, z którym nawiązujesz połączenie.

--repository-type

Typ konfiguracji repozytorium.

akceptowane wartości: AzureDevOpsGit, GitHub
--root-folder

Nazwa folderu do lokalizacji zasobów JSON usługi Azure Synapse jest importowana. Wartość domyślna to /.

wartość domyślna: /
--tags

Tagi rozdzielone spacjami: klucz[=wartość] [klucz[=wartość] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--tenant-id

Identyfikator dzierżawy używany do łączenia usługi Azure devops.

az synapse workspace delete

Usuń obszar roboczy usługi Synapse.

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

Przykłady

Usuń obszar roboczy usługi Synapse.

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

Parametry opcjonalne

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacją). Powinien to być kompletny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa obszaru roboczego.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--yes -y

Nie monituj o potwierdzenie.

az synapse workspace list

Wyświetl listę wszystkich obszarów roboczych usługi Synapse.

az synapse workspace list [--resource-group]

Przykłady

Wyświetlanie listy wszystkich obszarów roboczych usługi Synapse w ramach subskrypcji

az synapse workspace list

Wyświetlanie listy wszystkich obszarów roboczych usługi Synapse w ramach określonej grupy zasobów

az synapse workspace list --resource-group rg

Parametry opcjonalne

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

az synapse workspace show

Pobierz obszar roboczy usługi Synapse.

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

Przykłady

Pobierz obszar roboczy usługi Synapse.

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

Parametry opcjonalne

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacją). Powinien to być kompletny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--name -n

Nazwa obszaru roboczego.

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

az synapse workspace update

Aktualizowanie obszaru roboczego usługi Synapse.

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

Przykłady

Aktualizowanie obszaru roboczego usługi Synapse

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

Parametry opcjonalne

--account-name

GitHub nazwa konta używana dla repozytorium lub nazwy organizacji usługi Azure devops.

--allowed-tenant-ids

Zatwierdzone dzierżawy usługi Azure AD, do których dozwolony jest ruch wychodzący danych. Dzierżawa usługi Azure AD bieżącego użytkownika zostanie domyślnie dołączona. Użyj polecenia ('' w programie PowerShell), aby wyłączyć wszystkie dozwolone identyfikatory dzierżawy.

--collaboration-branch

Nazwa gałęzi, w której będziesz współpracować z innymi osobami i z których będziesz publikować.

--host-name

W przypadku korzystania z usługi github Enterprise Server podaj adres URL serwera, tak aby https://github.mydomain.com.Do nie używać tej opcji z usługą GitHub Enterprise Cloud.

--ids

Co najmniej jeden identyfikator zasobu (rozdzielany spacją). Powinien to być kompletny identyfikator zasobu zawierający wszystkie informacje o argumentach "Identyfikator zasobu". Należy podać argumenty --ids lub inne argumenty "Identyfikator zasobu".

--key-name

Nazwa wyświetlana klucza zarządzanego przez klienta obszaru roboczego. Wszystkie istniejące klucze można znaleźć przy użyciu polecenia cmdlet "az synapse workspace key list".

--name -n

Nazwa obszaru roboczego.

--no-wait

Nie czekaj na zakończenie długotrwałej operacji.

--project-name

Nazwa projektu, z którym nawiązujesz połączenie.

--repository-name

Nazwa repozytorium, z którym nawiązujesz połączenie.

--repository-type

Typ konfiguracji repozytorium.

akceptowane wartości: AzureDevOpsGit, GitHub
--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--root-folder

Nazwa folderu do lokalizacji zasobów JSON usługi Azure Synapse jest importowana. Wartość domyślna to /.

--sql-admin-login-password -p

Hasło logowania administratora sql.

--tags

Tagi rozdzielone spacjami: klucz[=wartość] [klucz[=wartość] ...]. Użyj ciągu "", aby wyczyścić istniejące tagi.

--tenant-id

Identyfikator dzierżawy używany do łączenia usługi Azure devops.

az synapse workspace wait

Umieść interfejs wiersza polecenia w stanie oczekiwania do momentu spełnienia warunku obszaru roboczego.

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

Parametry wymagane

--resource-group -g

Nazwa grupy zasobów. Grupę domyślną można skonfigurować przy użyciu polecenia az configure --defaults group=<name>.

--workspace-name

Nazwa obszaru roboczego.

Parametry opcjonalne

--created

Zaczekaj na utworzenie polecenia "provisioningState" w lokalizacji "Powodzenie".

--custom

Zaczekaj, aż warunek spełnia niestandardowe zapytanie JMESPath. Na przykład provisioningState!='InProgress', instanceView.statuses[?code=='PowerState/running'].

--deleted

Zaczekaj na usunięcie.

--exists

Zaczekaj, aż zasób istnieje.

--interval

Interwał sondowania w sekundach.

wartość domyślna: 30
--timeout

Maksymalny czas oczekiwania w sekundach.

wartość domyślna: 3600
--updated

Zaczekaj na aktualizację za pomocą parametru provisioningState w lokalizacji "Powodzenie".