Invoke-AzureHDInsightHiveJob
Sendet Hive-Abfragen an einen HDInsight-Cluster, zeigt den Fortschritt der Abfrageausführung an und ruft Abfrageergebnisse in einem Einzigen Vorgang ab.
Hinweis
Die Cmdlets, auf die in dieser Dokumentation verwiesen wird, dienen zum Verwalten von Azure-Legacyressourcen, die Azure Dienst-Manager (ASM) APIs verwenden. Dieses ältere PowerShell-Modul wird beim Erstellen neuer Ressourcen nicht empfohlen, da ASM für den Ruhestand geplant ist. Weitere Informationen finden Sie unter Einstellung des Azure Service Manager.
Das Az PowerShell-Modul ist das empfohlene PowerShell-Modul zum Verwalten von Azure Resource Manager (ARM)-Ressourcen mit PowerShell.
Syntax
Invoke-AzureHDInsightHiveJob
[-Arguments <String[]>]
[-Defines <Hashtable>]
[-File <String>]
[-Files <String[]>]
[-JobName <String>]
[-Query <String>]
[-RunAsFileJob]
[-StatusFolder <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Beschreibung
Diese Version von Azure PowerShell HDInsight ist veraltet. Diese Cmdlets werden bis zum 1. Januar 2017 entfernt. Verwenden Sie die neuere Version von Azure PowerShell HDInsight.
Informationen zur Verwendung des neuen HDInsight zum Erstellen eines Clusters finden Sie unter Erstellen linuxbasierter Cluster in HDInsight mithilfe von Azure PowerShell (https://azure.microsoft.com/en-us/documentation/articles/hdinsight-hadoop-create-linux-clusters-azure-powershell/). Informationen zum Übermitteln von Aufträgen mithilfe von Azure PowerShell und anderen Ansätzen finden Sie unter Submit Hadoop jobs in HDInsight (https://azure.microsoft.com/en-us/documentation/articles/hdinsight-submit-hadoop-jobs-programmatically/). Referenzinformationen zu Azure PowerShell HDInsight finden Sie unter Azure HDInsight-Cmdlets.
Das Cmdlet Invoke-AzureHDInsightHiveJob sendet Hive-Abfragen an einen HDInsight-Cluster, zeigt den Fortschritt der Abfrageausführung an und ruft die Abfrageergebnisse in einem Einzigen Vorgang ab. Sie müssen das Cmdlet Use-AzureHDInsightCluster ausführen, bevor Sie Invoke-AzureHDInsightHiveJob ausführen, um den HDInsight-Cluster anzugeben, an den eine Abfrage übermittelt werden soll.
Beispiele
Beispiel 1: Übermitteln einer Strukturabfrage
PS C:\>Use-AzureHDInsightCluster "Cluster01" -Subscription (Get-AzureSubscription -Current).SubscriptionId
PS C:\> Invoke-AzureHDInsightHiveJob "select * from hivesampletable limit 10"Der erste Befehl verwendet das Cmdlet Use-AzureHDInsightCluster , um einen Cluster im aktuellen Abonnement anzugeben, der für eine Strukturabfrage verwendet werden soll.
Der zweite Befehl verwendet das Cmdlet Invoke-AzureHDInsightHiveJob , um die Strukturabfrage zu übermitteln.
Parameter
-Arguments
Gibt ein Array von Argumenten für einen Hadoop-Auftrag an. Die Argumente werden als Befehlszeilenargumente an jeden Vorgang übergeben.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Defines
Gibt Hadoop-Konfigurationswerte an, die festgelegt werden sollen, wenn ein Auftrag ausgeführt wird.
| Typ: | Hashtable |
| Aliase: | Params |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-File
Gibt den Windows Azure Storage Blob (WASB)-Pfad zu einer Datei im Azure Blob Storage an, die die auszuführende Abfrage enthält. Sie können diesen Parameter anstelle des Abfrageparameters verwenden.
| Typ: | String |
| Aliase: | QueryFile |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Files
Gibt eine Auflistung von Dateien an, die für einen Strukturauftrag erforderlich sind.
| Typ: | String[] |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-JobName
Gibt den Namen eines Strukturauftrags an. Wenn Sie diesen Parameter nicht angeben, verwendet dieses Cmdlet den Standardwert: "Struktur: <erste 100 Zeichen der Abfrage>".
| Typ: | String |
| Aliase: | Name |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Profile
Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.
| Typ: | AzureSMProfile |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-Query
Gibt eine Strukturabfrage an.
| Typ: | String |
| Aliase: | QueryText |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-RunAsFileJob
Gibt an, dass dieses Cmdlet eine Datei im Standardmäßigen Azure-Speicherkonto erstellt, in dem eine Abfrage gespeichert werden soll. Dieses Cmdlet sendet den Auftrag, der auf diese Datei als Skript verweist, das ausgeführt werden soll.
Sie können diese Funktion verwenden, um Sonderzeichen wie Prozentzeichen (%) zu behandeln, die bei einer Auftragsübermittlung über Templeton fehlschlagen würden, da Templeton eine Abfrage mit einem Prozentzeichen als URL-Parameter interpretiert.
| Typ: | SwitchParameter |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |
-StatusFolder
Gibt den Speicherort des Ordners an, der Standardausgaben und Fehlerausgaben für einen Auftrag enthält, einschließlich des Ausgangscodes und der Aufgabenprotokolle.
| Typ: | String |
| Position: | Named |
| Standardwert: | None |
| Erforderlich: | False |
| Pipelineeingabe akzeptieren: | False |
| Platzhalterzeichen akzeptieren: | False |