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 Dienstverwaltungs-APIs verwenden. Cmdlets zum Verwalten von Azure Ressource Manager-Ressourcen finden Sie im Az PowerShell-Modul.

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.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Defines

Gibt Hadoop-Konfigurationswerte an, die festgelegt werden sollen, wenn ein Auftrag ausgeführt wird.

Type:Hashtable
Aliases:Params
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Aliases:QueryFile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Files

Gibt eine Auflistung von Dateien an, die für einen Strukturauftrag erforderlich sind.

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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>".

Type:String
Aliases:Name
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Profile

Gibt das Azure-Profil an, aus dem dieses Cmdlet liest. Wenn Sie kein Profil angeben, liest dieses Cmdlet aus dem lokalen Standardprofil.

Type:AzureSMProfile
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Query

Gibt eine Strukturabfrage an.

Type:String
Aliases:QueryText
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters: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.

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False