透過Azure PowerShell Cmdlet 和 REST API 將程式庫管理程式自動化

  • 發行項

您可能想要管理無伺服器 Apache Spark 集區的程式庫，而不需要進入 Synapse Analytics UI 頁面。 例如，您可能發現：

  • 您開發自訂套件，並想要將其上傳至您的工作區，然後在 Spark 集區中使用。 另外您想要在本地工具上完成步驟，而不需要造訪套件管理 UI。
  • 您正透過持續整合與持續傳遞程序更新套件

在本文中，我們將提供一般指南，協助您透過 Azure PowerShell Cmdlet 或 REST API 來管理程式庫。

透過 Azure PowerShell Cmdlet 管理套件

新增程式庫

  1. New-AzSynapseWorkspacePackage 命令可用來將新程式庫上傳至工作區。

    New-AzSynapseWorkspacePackage -WorkspaceName ContosoWorkspace -Package ".\ContosoPackage.whl"

  2. New-AzSynapseWorkspacePackage 和 Update-AzSynapseSparkPool 命令的組合可用來將新程式庫上傳至工作區，以及將程式庫連結至 Spark 集區。

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

  3. 如果您想要將現有的工作區程式庫附加至 Spark 集區，請參閱 Get-AzSynapseWorkspacePackage 和 Update-AzSynapseSparkPool 的命令組合。

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

移除程式庫

  1. 若要從 Spark 集區移除已安裝套件，請參閱 Get-AzSynapseWorkspacePackage 和 Update-AzSynapseSparkPool 的命令組合。

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

  2. 您也可以透過呼叫 Get-AzSynapseSparkPool 和 Update-AzSynapseSparkPool 命令，從集區擷取 Spark 集區並移除所有連結的工作區程式庫。

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

如需更多 Azure PowerShell Cmdlet 功能，請參閱適用於 Azure Synapse Analytics 的 Azure PowerShell Cmdlet。

透過 REST API 管理套件

管理工作區套件

透過 REST API 的功能，您可以新增/刪除套件，或列出工作區的所有已上傳檔案。 若要查看完整的支援 API，請參閱工作區程式庫 API 的概觀。

管理 Spark 集區套件

您可以利用 Spark 集區 REST API，將自訂或開放原始碼程式庫連結或移除至 Spark 集區。

  1. 針對自訂程式庫，請在要求本文中將自訂檔案的清單指定為 customLibraries 屬性。

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

  2. 您也可以在要求本文中指定 libraryRequirements 屬性來更新 Spark 集區程式庫。

    "libraryRequirements": {
      "content": "",
      "filename": "requirements.txt"
}

下一步