Azure PowerShell cmdlet'leri ve REST API'leri aracılığıyla kitaplık yönetimi sürecini otomatikleştirme

Makale
03/10/2023

Sunucusuz Apache Spark havuzlarınız için kitaplıklarınızı Synapse Analytics kullanıcı arabirimi sayfalarına girmeden yönetmek isteyebilirsiniz. Örneğin, şunları bulabilirsiniz:

özel bir paket geliştirip bunu çalışma alanınıza yükleyip Spark havuzunuzda kullanmak istiyorsunuz. Ayrıca, paket yönetimi URI'lerini ziyaret etmeden yerel araçlarınızdaki adımları tamamlamak istiyorsunuz.
CI/CD işlemi aracılığıyla paketlerinizi güncelleştiriyorsanız

Bu makalede, kitaplıkları Azure PowerShell cmdlet'ler veya REST API'ler aracılığıyla yönetmenize yardımcı olacak genel bir kılavuz sağlayacağız.

Azure PowerShell cmdlet'leri aracılığıyla paketleri yönetme

Yeni kitaplık ekleme

New-AzSynapseWorkspacePackage komutu , yeni kitaplıkları çalışma alanına yüklemek için kullanılabilir.
```
New-AzSynapseWorkspacePackage -WorkspaceName ContosoWorkspace -Package ".\ContosoPackage.whl"
```

New-AzSynapseWorkspacePackage ve Update-AzSynapseSparkPool komutlarının birleşimi, yeni kitaplıkları çalışma alanına yüklemek ve kitaplığı bir Spark havuzuna eklemek için kullanılabilir.

$package = New-AzSynapseWorkspacePackage -WorkspaceName ContosoWorkspace -Package ".\ContosoPackage.whl"
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -PackageAction Add -Package $package

Spark havuzunuza mevcut bir çalışma alanı kitaplığı eklemek istiyorsanız, lütfen Get-AzSynapseWorkspacePackage ve Update-AzSynapseSparkPool komut bileşimine bakın.

$packages = Get-AzSynapseWorkspacePackage -WorkspaceName ContosoWorkspace
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -PackageAction Add -Package $packages

Kitaplıkları kaldırma

Yüklü bir paketi Spark havuzunuzdan kaldırmak için lütfen Get-AzSynapseWorkspacePackage ve Update-AzSynapseSparkPool komut bileşimine bakın.

$package = Get-AzSynapseWorkspacePackage -WorkspaceName ContosoWorkspace -Name ContosoPackage
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -PackageAction Remove -Package $package

Ayrıca Bir Spark havuzu alabilir ve Get-AzSynapseSparkPool ve Update-AzSynapseSparkPool komutlarını çağırarak ekli tüm çalışma alanı kitaplıklarınıhavuzdan kaldırabilirsiniz.

$pool = Get-AzSynapseSparkPool -ResourceGroupName ContosoResourceGroup -WorkspaceName ContosoWorkspace -Name ContosoSparkPool
$pool | Update-AzSynapseSparkPool -PackageAction Remove -Package $pool.WorkspacePackages

Daha fazla Azure PowerShell cmdlet özelliği için lütfen Azure Synapse Analytics için Azure PowerShell cmdlet'lerine bakın.

REST API'ler aracılığıyla paketleri yönetme

Çalışma alanı paketlerini yönetme

REST API'lerinin özelliği sayesinde paketleri ekleyebilir/silebilir veya çalışma alanınızın karşıya yüklenen tüm dosyalarını listeleyebilirsiniz. Desteklenen tam API'lere bakın, lütfen Çalışma alanı kitaplığı API'lerine genel bakış bölümüne bakın.

Spark havuzu paketlerini yönetme

Spark havuzlarınıza özel veya açık kaynak kitaplıklarınızı eklemek veya kaldırmak için Spark havuzu REST API'sini kullanabilirsiniz.

Özel kitaplıklar için lütfen özel dosyaların listesini istek gövdesinde customLibraries özelliği olarak belirtin.

"customLibraries": [
    {
        "name": "samplejartestfile.jar",
        "path": "<workspace-name>/libraries/<jar-name>.jar",
        "containerName": "prep",
        "uploadedTimestamp": "1970-01-01T00:00:00Z",
        "type": "jar"
    }
]

Ayrıca, istek gövdesinde libraryRequirements özelliğini belirterek Spark havuzu kitaplıklarınızı da güncelleştirebilirsiniz.
```
"libraryRequirements": {
      "content": "",
      "filename": "requirements.txt"
}
```

Sonraki adımlar

Varsayılan kitaplıkları görüntüleme: Apache Spark sürüm desteği
spark havuzu düzeyindeki paketleri Synapse Studio portalı aracılığıyla yönetme: Not Defteri Oturumunda Python paket yönetimi

Aracılığıyla paylaş