Compartir a través de

Invoke-AzureRmHDInsightHiveJob

  • Referencia
Módulo:
AzureRM.HDInsight

Envía una consulta de Hive a un clúster de HDInsight y recupera los resultados de la consulta en una sola operación.

Advertencia

El módulo AzureRM PowerShell ha quedado oficialmente obsoleto a partir del 29 de febrero de 2024. Se recomienda a los usuarios migrar de AzureRM al módulo Az PowerShell para seguir recibiendo soporte técnico y actualizaciones.

Aunque el módulo AzureRM puede seguir funcionando, ya no recibirá mantenimiento ni soporte técnico, lo que significa que su uso continuado queda a discreción y riesgo del usuario. Consulte nuestros recursos de migración para ver una guía sobre la transición al módulo Az.

Sintaxis

Invoke-AzureRmHDInsightHiveJob
      [-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

El cmdlet Invoke-AzureRmHDInsightHiveJob envía una consulta de Hive a un clúster de Azure HDInsight y recupera los resultados de la consulta en una operación. Use el cmdlet Use-AzureRmHDInsightCluster antes de llamar a Invoke-AzureRmHDInsightHiveJob para especificar qué clúster se usará para la consulta.

Ejemplos

Ejemplo 1: Envío de una consulta de Hive a un clúster de Azure HDInsight

PS C:\># Primary storage account info
PS C:\> $storageAccountResourceGroupName = "Group"
PS C:\> $storageAccountName = "yourstorageacct001"
PS C:\> $storageAccountKey = (Get-AzureRmStorageAccountKey -ResourceGroupName $storageAccountResourceGroupName -Name $storageAccountName)[0].value


PS C:\> $storageContainer = "container001"

# Cluster info
PS C:\> $clusterName = "your-hadoop-001"
PS C:\> $clusterCreds = Get-Credential

# Hive job details
PS C:\> $statusFolder = "tempStatusFolder/"
PS C:\> $query = "SHOW TABLES"

PS C:\> Use-AzureRmHDInsightCluster `
            -ClusterCredential $clusterCreds `
            -ClusterName $clusterName

PS C:\> Invoke-AzureRmHDInsightHiveJob -StatusFolder $statusFolder `
            -Query $query `
            -DefaultContainer $storageAccountContainer `
            -DefaultStorageAccountName "$storageAccountName.blob.core.windows.net" `
            -DefaultStorageAccountKey $storageAccountKey

Este comando envía la consulta SHOW TABLES al clúster denominado your-hadoop-001.

Parámetros

-Arguments

Especifica una matriz de argumentos para el trabajo. Los argumentos se pasan a cada tarea como argumentos de la línea de comandos.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultContainer

Especifica el nombre del contenedor predeterminado en la cuenta de Azure Storage predeterminada que usa un clúster de HDInsight.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultProfile

Las credenciales, la cuenta, el inquilino y la suscripción que se usan para la comunicación con Azure

Tipo:IAzureContextContainer
Alias:AzureRmContext, AzureCredential
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultStorageAccountKey

Especifica la clave de cuenta de la cuenta de almacenamiento predeterminada que usa el clúster de HDInsight.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-DefaultStorageAccountName

Especifica el nombre de la cuenta de almacenamiento predeterminada que usa el clúster de HDInsight.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Defines

Especifica los valores de configuración de Hadoop que se van a establecer cuando se ejecuta un trabajo.

Tipo:Hashtable
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-File

Especifica la ruta de acceso a un archivo de Azure Storage que contiene la consulta que se va a ejecutar. Puede usar este parámetro en lugar del parámetro Query .

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Files

Especifica una colección de archivos necesarios para un trabajo de Hive.

Tipo:String[]
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-JobName

Especifica el nombre de un trabajo de Hive. Si no especifica este parámetro, este cmdlet usa el valor predeterminado: "Hive: <primeros 100 caracteres de Query>".

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-Query

Especifica la consulta de Hive.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-RunAsFileJob

Indica que este cmdlet crea un archivo en la cuenta de almacenamiento de Azure predeterminada en la que se va a almacenar una consulta. Este cmdlet envía el trabajo que hace referencia a este archivo como un script que se va a ejecutar. Puede usar esta funcionalidad para controlar caracteres especiales, como el signo de porcentaje (%) que produciría un error en un envío de trabajo a través de Templeton, ya que Templeton interpreta una consulta con un signo de porcentaje como parámetro de dirección URL.

Tipo:SwitchParameter
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

-StatusFolder

Especifica la ubicación de la carpeta que contiene salidas estándar y salidas de error para un trabajo.

Tipo:String
Posición:Named
Valor predeterminado:None
Requerido:False
Aceptar entrada de canalización:False
Aceptar caracteres comodín:False

Entradas

None

Salidas

String