Freigeben über


Invoke-AzHDInsightHiveJob

Sendet eine Strukturabfrage an einen HDInsight-Cluster und ruft Abfrageergebnisse in einem Einzigen Vorgang ab.

Syntax

Default (Standard)

Invoke-AzHDInsightHiveJob
    [-Arguments <String[]>]
    [-Files <String[]>]
    [-StatusFolder <String>]
    [-Defines <Hashtable>]
    [-File <String>]
    [-JobName <String>]
    [-Query <String>]
    [-RunAsFileJob]
    [-DefaultContainer <String>]
    [-DefaultStorageAccountName <String>]
    [-DefaultStorageAccountKey <String>]
    [-DefaultProfile <IAzureContextContainer>]
    [<CommonParameters>]

Beschreibung

Das Cmdlet Invoke-AzHDInsightHiveJob sendet eine Hive-Abfrage an einen Azure HDInsight-Cluster und ruft Abfrageergebnisse in einem Einzigen Vorgang ab. Verwenden Sie das cmdlet Use-AzHDInsightCluster, bevor Sie Invoke-AzHDInsightHiveJob aufrufen, um anzugeben, welcher Cluster für die Abfrage verwendet wird.

Beispiele

Beispiel 1: Senden einer Strukturabfrage an einen Azure HDInsight-Cluster

# Primary storage account info
$storageAccountResourceGroupName = "Group"
$storageAccountName = "yourstorageacct001"
$storageAccountKey = (Get-AzStorageAccountKey -ResourceGroupName $storageAccountResourceGroupName -Name $storageAccountName)[0].value


$storageContainer = "container001"

# Cluster info
$clusterName = "your-hadoop-001"
$clusterCreds = Get-Credential

# Hive job details
$statusFolder = "tempStatusFolder/"
$query = "SHOW TABLES"

Use-AzHDInsightCluster `
            -ClusterCredential $clusterCreds `
            -ClusterName $clusterName

Invoke-AzHDInsightHiveJob -StatusFolder $statusFolder `
            -Query $query `
            -DefaultContainer $storageContainer `
            -DefaultStorageAccountName "$storageAccountName.blob.core.windows.net" `
            -DefaultStorageAccountKey $storageAccountKey

Mit diesem Befehl wird die Abfrage SHOW TABLES an den Cluster mit dem Namen "your-hadoop-001" übermittelt.

Parameter

-Arguments

Gibt ein Array von Argumenten für den Auftrag an. Die Argumente werden als Befehlszeilenargumente an jeden Vorgang übergeben.

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultContainer

Gibt den Namen des Standardcontainers im Standardmäßigen Azure Storage-Konto an, das ein HDInsight-Cluster verwendet.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultProfile

Anmeldeinformationen, Konto, Mandant und Abonnement für die Kommunikation mit Azure

Parametereigenschaften

Typ:IAzureContextContainer
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False
Aliase:AzContext, AzureRmContext, AzureCredential

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultStorageAccountKey

Gibt den Kontoschlüssel für das Standardspeicherkonto an, das der HDInsight-Cluster verwendet.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-DefaultStorageAccountName

Gibt den Namen des Standardspeicherkontos an, das der HDInsight-Cluster verwendet.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Defines

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

Parametereigenschaften

Typ:Hashtable
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-File

Gibt den Pfad zu einer Datei in Azure Storage an, die die auszuführende Abfrage enthält. Sie können diesen Parameter anstelle des Abfrageparameters verwenden.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Files

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

Parametereigenschaften

Typ:

String[]

Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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>".

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-Query

Gibt die Strukturabfrage an.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten: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 verarbeiten, die bei einer Auftragsübermittlung über Templeton fehlschlagen würden, da Templeton eine Abfrage mit einem Prozentzeichen als URL-Parameter interpretiert.

Parametereigenschaften

Typ:SwitchParameter
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

-StatusFolder

Gibt den Speicherort des Ordners an, der Standardausgaben und Fehlerausgaben für einen Auftrag enthält.

Parametereigenschaften

Typ:String
Standardwert:None
Unterstützt Platzhalter:False
Nicht anzeigen:False

Parametersätze

(All)
Position:Named
Obligatorisch:False
Wert aus Pipeline:False
Wert aus Pipeline nach dem Eigenschaftsnamen:False
Wert aus verbleibenden Argumenten:False

CommonParameters

Dieses Cmdlet unterstützt die allgemeinen Parameter -Debug, -ErrorAction, -ErrorVariable, -InformationAction, -InformationVariable, -OutBuffer, -OutVariable, -PipelineVariable, -ProgressAction, -Verbose, -WarningAction und -WarningVariable. Weitere Informationen findest du unter about_CommonParameters.

Eingaben

None

Ausgaben

String