Partager via


Invoke-AzHDInsightHiveJob

Envoie une requête Hive à un cluster HDInsight et récupère les résultats de la requête en une seule opération.

Syntaxe

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>]

Description

L’applet de commande Invoke-AzHDInsightHiveJob envoie une requête Hive à un cluster Azure HDInsight et récupère les résultats de la requête en une seule opération. Utilisez l’applet de commande Use-AzHDInsightCluster avant d’appeler Invoke-AzHDInsightHiveJob pour spécifier le cluster qui sera utilisé pour la requête.

Exemples

Exemple 1 : Envoyer une requête Hive à un cluster Azure HDInsight

# 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

Cette commande envoie la requête SHOW TABLES au cluster nommé your-hadoop-001.

Paramètres

-Arguments

Spécifie un tableau d’arguments pour le travail. Les arguments sont passés sous la forme d’arguments de ligne de commande à chaque tâche.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultContainer

Spécifie le nom du conteneur par défaut dans le compte de Stockage Azure par défaut qu’un cluster HDInsight utilise.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultProfile

Informations d’identification, compte, locataire et abonnement utilisés pour la communication avec Azure

Type:IAzureContextContainer
Alias:AzContext, AzureRmContext, AzureCredential
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultStorageAccountKey

Spécifie la clé de compte pour le compte de stockage par défaut que le cluster HDInsight utilise.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-DefaultStorageAccountName

Spécifie le nom du compte de stockage par défaut que le cluster HDInsight utilise.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Defines

Spécifie les valeurs de configuration Hadoop à définir lors de l’exécution d’un travail.

Type:Hashtable
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-File

Spécifie le chemin d’accès à un fichier dans Stockage Azure qui contient la requête à exécuter. Vous pouvez utiliser ce paramètre au lieu du paramètre De requête .

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Files

Spécifie une collection de fichiers requis pour un travail Hive.

Type:String[]
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-JobName

Spécifie le nom d’un travail Hive. Si vous ne spécifiez pas ce paramètre, cette applet de commande utilise la valeur par défaut : « Hive : <100 premiers caractères de requête> ».

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-Query

Spécifie la requête Hive.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-RunAsFileJob

Indique que cette applet de commande crée un fichier dans le compte de stockage Azure par défaut dans lequel stocker une requête. Cette applet de commande envoie le travail qui fait référence à ce fichier en tant que script à exécuter. Vous pouvez utiliser cette fonctionnalité pour gérer des caractères spéciaux tels que le signe de pourcentage (%) qui échoueraient sur une soumission de travail via Templeton, car Templeton interprète une requête avec un signe de pourcentage comme paramètre d’URL.

Type:SwitchParameter
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

-StatusFolder

Spécifie l’emplacement du dossier qui contient des sorties standard et des sorties d’erreur pour un travail.

Type:String
Position:Named
Valeur par défaut:None
Obligatoire:False
Accepter l'entrée de pipeline:False
Accepter les caractères génériques:False

Entrées

None

Sorties

String