Update-AzSynapseSparkPool
Aktualizacje pulę platformy Apache Spark w usłudze Azure Synapse Analytics.
Składnia
Update-AzSynapseSparkPool
[-ResourceGroupName <String>]
-WorkspaceName <String>
-Name <String>
[-Tag <Hashtable>]
[-EnableAutoScale <Boolean>]
[-AutoScaleMinNodeCount <Int32>]
[-AutoScaleMaxNodeCount <Int32>]
[-EnableAutoPause <Boolean>]
[-AutoPauseDelayInMinute <Int32>]
[-NodeCount <Int32>]
[-EnableIsolatedCompute <Boolean>]
[-NodeSize <String>]
[-EnableDynamicExecutorAllocation <Boolean>]
[-MinExecutorCount <Int32>]
[-MaxExecutorCount <Int32>]
[-SparkVersion <String>]
[-LibraryRequirementsFilePath <String>]
[-SparkConfiguration <PSSparkConfigurationResource>]
[-PackageAction <PackageActionType>]
[-Package <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Synapse.Models.WorkspacePackages.PSSynapseWorkspacePackage]>]
[-ForceApplySetting]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzSynapseSparkPool
-Name <String>
-WorkspaceObject <PSSynapseWorkspace>
[-Tag <Hashtable>]
[-EnableAutoScale <Boolean>]
[-AutoScaleMinNodeCount <Int32>]
[-AutoScaleMaxNodeCount <Int32>]
[-EnableAutoPause <Boolean>]
[-AutoPauseDelayInMinute <Int32>]
[-NodeCount <Int32>]
[-EnableIsolatedCompute <Boolean>]
[-NodeSize <String>]
[-EnableDynamicExecutorAllocation <Boolean>]
[-MinExecutorCount <Int32>]
[-MaxExecutorCount <Int32>]
[-SparkVersion <String>]
[-LibraryRequirementsFilePath <String>]
[-SparkConfiguration <PSSparkConfigurationResource>]
[-PackageAction <PackageActionType>]
[-Package <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Synapse.Models.WorkspacePackages.PSSynapseWorkspacePackage]>]
[-ForceApplySetting]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzSynapseSparkPool
-InputObject <PSSynapseSparkPool>
[-Tag <Hashtable>]
[-EnableAutoScale <Boolean>]
[-AutoScaleMinNodeCount <Int32>]
[-AutoScaleMaxNodeCount <Int32>]
[-EnableAutoPause <Boolean>]
[-AutoPauseDelayInMinute <Int32>]
[-NodeCount <Int32>]
[-EnableIsolatedCompute <Boolean>]
[-NodeSize <String>]
[-EnableDynamicExecutorAllocation <Boolean>]
[-MinExecutorCount <Int32>]
[-MaxExecutorCount <Int32>]
[-SparkVersion <String>]
[-LibraryRequirementsFilePath <String>]
[-SparkConfiguration <PSSparkConfigurationResource>]
[-PackageAction <PackageActionType>]
[-Package <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Synapse.Models.WorkspacePackages.PSSynapseWorkspacePackage]>]
[-ForceApplySetting]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Update-AzSynapseSparkPool
-ResourceId <String>
[-Tag <Hashtable>]
[-EnableAutoScale <Boolean>]
[-AutoScaleMinNodeCount <Int32>]
[-AutoScaleMaxNodeCount <Int32>]
[-EnableAutoPause <Boolean>]
[-AutoPauseDelayInMinute <Int32>]
[-NodeCount <Int32>]
[-EnableIsolatedCompute <Boolean>]
[-NodeSize <String>]
[-EnableDynamicExecutorAllocation <Boolean>]
[-MinExecutorCount <Int32>]
[-MaxExecutorCount <Int32>]
[-SparkVersion <String>]
[-LibraryRequirementsFilePath <String>]
[-SparkConfiguration <PSSparkConfigurationResource>]
[-PackageAction <PackageActionType>]
[-Package <System.Collections.Generic.List`1[Microsoft.Azure.Commands.Synapse.Models.WorkspacePackages.PSSynapseWorkspacePackage]>]
[-ForceApplySetting]
[-AsJob]
[-DefaultProfile <IAzureContextContainer>]
[-WhatIf]
[-Confirm]
[<CommonParameters>]
Opis
Polecenie cmdlet Update-AzSynapseSparkPool aktualizuje pulę platformy Apache Spark w usłudze Azure Synapse Analytics.
Uwaga
-SparkVersion
Jeśli parametr jest używany do uaktualniania wersji środowiska uruchomieniowego platformy Synapse Spark, upewnij się, że pula Spark nie ma żadnych dołączonych bibliotek niestandardowych ani pakietów. Aby uzyskać więcej informacji, zobacz Migracja między wersjami platformy Apache Spark.
Przykłady
Przykład 1
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -Tag @{"key" = "value"} -NodeCount 5 -NodeSize Medium
To polecenie aktualizuje pulę platformy Apache Spark w usłudze Azure Synapse Analytics.
Przykład 2
$pool = Get-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool
$pool | Update-AzSynapseSparkPool -Tag @{"key" = "value1"}
To polecenie aktualizuje pulę platformy Apache Spark w usłudze Azure Synapse Analytics za pośrednictwem potoku.
Przykład 3
$ws = Get-AzSynapseWorkspace -Name ContosoWorkspace
$ws | Update-AzSynapseSparkPool -Name ContosoSparkPool -Tag @{"key" = "value2"}
To polecenie aktualizuje pulę platformy Apache Spark w usłudze Azure Synapse Analytics za pośrednictwem potoku.
Przykład 4
Update-AzSynapseSparkPool -ResourceId /subscriptions/21686af7-58ec-4f4d-9c68-f431f4db4edd/resourceGroups/ContosoResourceGroup/providers/Microsoft.Synapse/workspaces/ContosoWorkspace/bigDataPools/ContosoSparkPool -Tag @{"key" = "value3"}
To polecenie aktualizuje pulę platformy Apache Spark w usłudze Azure Synapse Analytics przy użyciu identyfikatora zasobu.
Przykład 5
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -EnableAutoScale $true -AutoScaleMinNodeCount 3 -AutoScaleMaxNodeCount 7
To polecenie umożliwia automatyczne skalowanie puli platformy Apache Spark w usłudze Azure Synapse Analytics.
Przykład 6
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -EnableAutoScale $false
To polecenie wyłącza automatyczne skalowanie puli platformy Apache Spark w usłudze Azure Synapse Analytics.
Przykład 7
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -EnableAutoPause $true -AutoPauseDelayInMinute 15
To polecenie umożliwia automatyczne wstrzymywanie puli platformy Apache Spark w usłudze Azure Synapse Analytics.
Przykład 8
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -EnableAutoPause $false
To polecenie wyłącza automatyczne wstrzymywanie puli platformy Apache Spark w usłudze Azure Synapse Analytics.
Przykład 9
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -EnableDynamicExecutorAllocation $true -MinExecutorCount 1 -MaxExecutorCount 5
To polecenie umożliwia dynamiczną alokację funkcji wykonawczej i określ minimalną liczbę funkcji wykonawczej i maksymalną liczbę funkcji wykonawczej dla puli platformy Apache Spark w usłudze Azure Synapse Analytics.
Przykład 10
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -EnableDynamicExecutorAllocation $false
To polecenie wyłącza dynamiczną alokację funkcji wykonawczej dla puli platformy Apache Spark w usłudze Azure Synapse Analytics.
Przykład 11
$packages = Get-AzSynapseWorkspacePackage -WorkspaceName ContosoWorkspace
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -PackageAction Add -Package $packages
Pierwsze polecenie pobiera pakiety obszarów roboczych. Drugie polecenie łączy te pakiety obszarów roboczych z pulą platformy Apache Spark w usłudze Azure Synapse Analytics.
Przykład 12
$package = Get-AzSynapseWorkspacePackage -WorkspaceName ContosoWorkspace -Name ContosoPackage
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -PackageAction Remove -Package $package
Pierwsze polecenie pobiera pakiety obszarów roboczych o nazwie ContosoPackage. Drugie polecenie usuwa pakiet obszaru roboczego z puli Platformy Apache Spark w usłudze Azure Synapse Analytics.
Przykład 13
$pool = Get-AzSynapseSparkPool -ResourceGroupName ContosoResourceGroup -WorkspaceName ContosoWorkspace -Name ContosoSparkPool
$pool | Update-AzSynapseSparkPool -PackageAction Remove -Package $pool.WorkspacePackages
Pierwsze polecenie pobiera pulę platformy Apache Spark w usłudze Azure Synapse Analytics. Drugie polecenie usuwa wszystkie pakiety obszarów roboczych połączone z pulą platformy Apache Spark.
Przykład 14
$workspace_packages = Get-AzSynapseWorkspacePackage -WorkspaceName ContosoWorkspace
$pool = Get-AzSynapseSparkPool -ResourceGroupName ContosoResourceGroup -WorkspaceName ContosoWorkspace -Name ContosoSparkPool
$library_names = $pool.WorkspacePackages | Where-Object {$_.name -notlike "new_package-*"} | ForEach-Object {$_.name}
$library_names += "new_package-2.0-py3-none-any.whl"
$new_pool_packages = @($workspace_packages | Where-Object {$_.name -in $library_names})
Update-AzSynapseSparkPool -ResourceGroupName ContosoResourceGroup -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -PackageAction Set -Package $new_pool_packages
Pierwsze polecenie pobiera pakiety dostępne w obszarze roboczym. Druga grupa poleceń pobiera pulę platformy Spark, aby pobrać pakiety aktualnie połączone z new_package-
tą pulą i usuwa wszystkie wersje pakietu, począwszy od pobranej listy. Nowa wersja pakietu zostanie następnie dodana do tej listy. W trzeciej grupie poleceń lista pakietów zawierająca tylko nazwy pakietów jest przekształcana na listę pakietów obszarów roboczych, filtrując odpowiednio listę dostępnych workspace_packages, a następnie połączona z pulą spark.
Przykład 15
$config = Get-AzSynapseSparkConfiguration -WorkspaceName ContosoWorkspace -Name ContosoSparkConfig1
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -Tag @{"key" = "value"} -NodeCount 5 -NodeSize Medium -SparkConfiguration $configs
To polecenie aktualizuje pulę platformy Apache Spark w usłudze Azure Synapse Analytics i określa konfigurację platformy Spark dla puli Spark.
Przykład 16
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -NodeSize small -ForceApplySetting
To polecenie aktualizuje pulę platformy Apache Spark w usłudze Azure Synapse Analytics, ustaw wartość NodeSize na małą dla puli spark i wymuś zatrzymanie wszystkich uruchomionych zadań w puli Spark, aby zastosować to nowe ustawienie.
Przykład 17
$pool = Get-AzSynapseSparkPool -ResourceGroupName ContosoResourceGroup -WorkspaceName ContosoWorkspace -Name ContosoSparkPool
$pool | Update-AzSynapseSparkPool -PackageAction Remove -Package $pool.WorkspacePackages -ForceApplySetting
Pierwsze polecenie pobiera pulę platformy Apache Spark w usłudze Azure Synapse Analytics. Drugie polecenie usuwa wszystkie pakiety obszarów roboczych połączone z tą pulą platformy Apache Spark i wymusza zatrzymanie wszystkich uruchomionych zadań w puli Spark w celu zastosowania tego nowego ustawienia.
Przykład 18
Update-AzSynapseSparkPool -WorkspaceName ContosoWorkspace -Name ContosoSparkPool -EnableIsolatedCompute $true -NodeSize XXXLarge
To polecenie umożliwia izolowane obliczenia i określ rozmiar węzła xxXLarge(80 vCPU / 504 GB) dla puli Platformy Apache Spark w usłudze Azure Synapse Analytics.
Parametry
-AsJob
Uruchamianie polecenia cmdlet w tle
Typ: | SwitchParameter |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoPauseDelayInMinute
Liczba minut bezczynności. Ten parametr można określić po włączeniu automatycznego wstrzymywania. Wartość domyślna będzie wynosić [15], jeśli nie zostanie określona ręcznie.
Typ: | Int32 |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScaleMaxNodeCount
Maksymalna liczba węzłów do przydzielenia w określonej puli Spark. Ten parametr należy określić po włączeniu automatycznego skalowania.
Typ: | Int32 |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-AutoScaleMinNodeCount
Minimalna liczba węzłów do przydzielenia w określonej puli spark. Ten parametr należy określić po włączeniu automatycznego skalowania.
Typ: | Int32 |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Confirm
Monituje o potwierdzenie przed uruchomieniem polecenia cmdlet.
Typ: | SwitchParameter |
Aliases: | cf |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-DefaultProfile
Poświadczenia, konto, dzierżawa i subskrypcja używane do komunikacji z platformą Azure.
Typ: | IAzureContextContainer |
Aliases: | AzContext, AzureRmContext, AzureCredential |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableAutoPause
Wskazuje, czy ma być włączona funkcja automatycznego wstrzymywania.
Typ: | Nullable<T>[Boolean] |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableAutoScale
Wskazuje, czy ma być włączone automatyczne skalowanie
Typ: | Nullable<T>[Boolean] |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableDynamicExecutorAllocation
Wskazuje, czy należy włączyć dynamiczną alokację funkcji wykonawczej.
Typ: | Nullable<T>[Boolean] |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-EnableIsolatedCompute
Opcja Izoluj obliczenia jest dostępna tylko w przypadku rozmiaru węzła XXXLarge (80 vCPU/504 GB). Włączenie tej opcji zapewnia izolację zasobów obliczeniowych platformy Apache Spark dla niezaufanych usług. Izolowane koszty obliczeń są takie same jak nieizolowana maszyna wirtualna o tym samym rozmiarze. Jeśli oczekujesz włączenia izolowanego środowiska obliczeniowego dla puli spark, upewnij się, że obszar roboczy usługi Synapse został utworzony w izolowanym regionie obsługiwanym przez zasoby obliczeniowe, zapoznaj się z tym dokumentem, aby uzyskać więcej informacji: https://learn.microsoft.com/en-us/azure/synapse-analytics/spark/apache-spark-pool-configurations#isolated-compute.
Typ: | Nullable<T>[Boolean] |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ForceApplySetting
Czy zatrzymać jakiekolwiek uruchomione zadania w puli danych big data.
Typ: | SwitchParameter |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-InputObject
Obiekt wejściowy puli platformy Spark, zwykle przekazywany przez potok.
Typ: | PSSynapseSparkPool |
Position: | Named |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
-LibraryRequirementsFilePath
Plik konfiguracji środowiska ("Dane wyjściowe blokowania pip").
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MaxExecutorCount
Maksymalna liczba funkcji wykonawczych do przydzielenia w określonej puli platformy Spark. Ten parametr można określić, gdy parametr DynamicExecutorAllocation jest włączony. Wartość powinna należeć do zakresu od 1 (włącznie) do wartości maximumNodeCount (wyłączność). Jeśli nie zostanie określona ręcznie, wartość domyślna będzie wynosić 2.
Typ: | Int32 |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-MinExecutorCount
Minimalna liczba funkcji wykonawczych do przydzielenia w określonej puli spark. Ten parametr można określić, gdy parametr DynamicExecutorAllocation jest włączony. Wartość powinna należeć do zakresu od 1 (włącznie) do wartości maxExecutors (wyłączność). Jeśli nie zostanie określony ręcznie, wartość domyślna będzie wynosić 1.
Typ: | Int32 |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Name
Nazwa puli platformy Spark usługi Synapse.
Typ: | String |
Aliases: | SparkPoolName |
Position: | Named |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NodeCount
Liczba węzłów do przydzielenia w określonej puli platformy Spark.
Typ: | Int32 |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-NodeSize
Liczba rdzeni i pamięci, które mają być używane dla węzłów przydzielonych w określonej puli spark. Ten parametr należy określić, gdy skalowanie automatyczne jest wyłączone
Typ: | String |
akceptowane wartości: | Small, Medium, Large, XLarge, XXLarge, XXXLarge |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Package
Pakiety obszarów roboczych.
Typ: | List<T>[PSSynapseWorkspacePackage] |
Aliases: | WorkspacePackage |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-PackageAction
Akcja pakietu musi być określona podczas dodawania lub usuwania pakietu obszaru roboczego z puli platformy Apache Spark.
Typ: | Microsoft.Azure.Commands.Synapse.Models.SynapseConstants+PackageActionType |
akceptowane wartości: | Add, Remove, Set |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceGroupName
Nazwa grupy zasobów.
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-ResourceId
Identyfikator zasobu puli Platformy Spark usługi Synapse.
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SparkConfiguration
Konfiguracja platformy Apache Spark. Po przesłaniu zadania do puli zostaną przywołyne właściwości określone w wybranej konfiguracji.
Typ: | PSSparkConfigurationResource |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-SparkVersion
Wersja platformy Apache Spark. Dozwolone wartości: 3.1,3.2,3.3
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-Tag
Ciąg, słownik ciągów tagów skojarzonych z zasobem.
Typ: | Hashtable |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WhatIf
Pokazuje, co się stanie po uruchomieniu polecenia cmdlet. Polecenie cmdlet nie zostało uruchomione.
Typ: | SwitchParameter |
Aliases: | wi |
Position: | Named |
wartość domyślna: | None |
Wymagane: | False |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkspaceName
Nazwa obszaru roboczego usługi Synapse.
Typ: | String |
Position: | Named |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | False |
Accept wildcard characters: | False |
-WorkspaceObject
obiekt wejściowy obszaru roboczego, zwykle przekazywany przez potok.
Typ: | PSSynapseWorkspace |
Position: | Named |
wartość domyślna: | None |
Wymagane: | True |
Accept pipeline input: | True |
Accept wildcard characters: | False |
Dane wejściowe
Dane wyjściowe
Opinia
https://aka.ms/ContentUserFeedback.
Dostępne już wkrótce: W 2024 r. będziemy stopniowo wycofywać zgłoszenia z serwisu GitHub jako mechanizm przesyłania opinii na temat zawartości i zastępować go nowym systemem opinii. Aby uzyskać więcej informacji, sprawdź:Prześlij i wyświetl opinię dla