Hızlı Başlangıç: Azure CLI ile Azure synapse çalışma alanı oluşturma

Azure CLI, Azure kaynaklarını yönetmek için Azure tarafından sunulan komut satırı deneyimidir. Azure Cloud Shell ile kendi tarayıcınızda da kullanabilirsiniz. Dilerseniz macOS, Linux veya Windows’a yükleyebilir ve komut satırından çalıştırabilirsiniz.

Bu hızlı başlangıçta, Azure CLI kullanarak bir Synapse çalışma alanı oluşturmayı öğreneceksiniz.

Azure aboneliğiniz yoksa başlamadan önce birücretsiz Azure hesabı oluşturun.

Ön koşullar

  • Azure Cloud Shell'de Bash ortamını kullanın. Daha fazla bilgi için bkz . Azure Cloud Shell'de Bash için hızlı başlangıç.

  • CLI başvuru komutlarını yerel olarak çalıştırmayı tercih ediyorsanız Azure CLI'yı yükleyin . Windows veya macOS üzerinde çalışıyorsanız Azure CLI’yi bir Docker kapsayıcısında çalıştırmayı değerlendirin. Daha fazla bilgi için bkz . Docker kapsayıcısında Azure CLI'yi çalıştırma.

    • Yerel yükleme kullanıyorsanız az login komutunu kullanarak Azure CLI ile oturum açın. Kimlik doğrulama işlemini tamamlamak için terminalinizde görüntülenen adımları izleyin. Diğer oturum açma seçenekleri için bkz . Azure CLI ile oturum açma.

    • İstendiğinde, ilk kullanımda Azure CLI uzantısını yükleyin. Uzantılar hakkında daha fazla bilgi için bkz. Azure CLI ile uzantıları kullanma.

    • Yüklü sürümü ve bağımlı kitaplıkları bulmak için az version komutunu çalıştırın. En son sürüme yükseltmek için az upgrade komutunu çalıştırın.

Azure CLI kullanarak Azure Synapse çalışma alanı oluşturma

  1. Azure Synapse çalışma alanı için kaynak oluşturmak için gerekli ortam değişkenlerini tanımlayın.

    Ortam Değişkeni Adı Açıklama
    StorageAccountName Mevcut ADLS 2. Nesil depolama hesabınızın adı.
    Depolama AccountResourceGroup Mevcut ADLS 2. Nesil depolama hesabı kaynak grubunuzun adı.
    FileShareName Mevcut depolama dosya sisteminizin adı.
    SynapseResourceGroup Azure Synapse kaynak grubunuz için yeni bir ad seçin.
    Region Azure bölgelerinden birini seçin.
    SynapseWorkspaceName Yeni Azure Synapse Çalışma Alanınız için benzersiz bir ad seçin.
    SqlUser Yeni kullanıcı adı için bir değer seçin.
    SqlPassword Güvenli bir parola seçin.
  2. Azure Synapse çalışma alanınız için kapsayıcı olarak bir kaynak grubu oluşturun:

    az group create --name $SynapseResourceGroup --location $Region
    
  3. Azure Synapse Çalışma Alanı oluşturma:

    az synapse workspace create \
      --name $SynapseWorkspaceName \
      --resource-group $SynapseResourceGroup \
      --storage-account $StorageAccountName \
      --file-system $FileShareName \
      --sql-admin-login-user $SqlUser \
      --sql-admin-login-password $SqlPassword \
      --location $Region
    
  4. Azure Synapse Çalışma Alanı için Web ve Geliştirme URL'sini alın:

    WorkspaceWeb=$(az synapse workspace show --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup | jq -r '.connectivityEndpoints | .web')
    
    WorkspaceDev=$(az synapse workspace show --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup | jq -r '.connectivityEndpoints | .dev')
    
  5. Makinenizden Azure Synapse Çalışma Alanına erişiminize izin vermek için bir Güvenlik Duvarı Kuralı oluşturun:

    ClientIP=$(curl -sb -H "Accept: application/json" "$WorkspaceDev" | jq -r '.message')
    ClientIP=${ClientIP##'Client Ip address : '}
    echo "Creating a firewall rule to enable access for IP address: $ClientIP"
    
    az synapse workspace firewall-rule create --end-ip-address $ClientIP --start-ip-address $ClientIP --name "Allow Client IP" --resource-group $SynapseResourceGroup --workspace-name $SynapseWorkspaceName
    
  6. Çalışma alanınıza erişmek için ortam değişkeninde WorkspaceWeb depolanan Azure Synapse Çalışma Alanı Web URL'si adresini açın:

    echo "Open your Azure Synapse Workspace Web URL in the browser: $WorkspaceWeb"
    

    Azure Synapse workspace web

  7. Dağıtıldıktan sonra ek izinler gerekir.

  • Azure portalında, çalışma alanının diğer kullanıcılarını çalışma alanında Katkıda Bulunan rolüne atayın. Ayrıntılı adımlar için bkz. Azure portalı kullanarak Azure rolleri atama.
  • Synapse Studio kullanarak diğer kullanıcılara uygun Synapse RBAC rollerini atayın.
  • Azure Depolama hesabının Sahip rolünün bir üyesi, Azure Synapse çalışma alanı MSI'sine ve diğer kullanıcılara Depolama Blob Veri Katkıda Bulunanı rolünü atamalıdır.

Kaynakları temizleme

Azure Synapse çalışma alanını silmek için aşağıdaki adımları izleyin.

Uyarı

Azure Synapse çalışma alanını silmek analiz altyapılarını ve kapsanan SQL havuzlarının ve çalışma alanı meta verilerinin veritabanında depolanan verileri kaldırır. Artık SQL veya Apache Spark uç noktalarına bağlanmak mümkün olmayacaktır. Tüm kod yapıtları silinir (sorgular, not defterleri, iş tanımları ve işlem hatları).

Çalışma alanının silinmesi, çalışma alanına bağlı Data Lake Store 2. Nesil'deki verileri etkilemez.

Azure Synapse çalışma alanını silmek istiyorsanız aşağıdaki komutu tamamlayın:

az synapse workspace delete --name $SynapseWorkspaceName --resource-group $SynapseResourceGroup

Sonraki adımlar

Ardından, verilerinizi analiz etmeye ve keşfetmeye başlamak için SQL havuzları veya Apache Spark havuzları oluşturabilirsiniz.