Invoke-AzureHDInsightHiveJob
Envía consultas de Hive a un clúster de HDInsight, muestra el progreso de la ejecución de la consulta y obtiene los resultados de la consulta en una sola operación.
Nota:
Los cmdlets a los que se hace referencia en esta documentación son para administrar recursos de Azure heredados que usan las API de Azure Service Management (ASM). Este módulo heredado de PowerShell no se recomienda al crear nuevos recursos, ya que ASM está programado para la retirada. Para más información, consulte Retirada de Azure Service Manager.
El módulo Az de PowerShell es el módulo de PowerShell recomendado para administrar recursos de Azure Resource Manager (ARM) con PowerShell.
Sintaxis
Invoke-AzureHDInsightHiveJob
[-Arguments <String[]>]
[-Defines <Hashtable>]
[-File <String>]
[-Files <String[]>]
[-JobName <String>]
[-Query <String>]
[-RunAsFileJob]
[-StatusFolder <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Description
Esta versión de HDInsight de Azure PowerShell está en desuso. Estos cmdlets se quitarán el 1 de enero de 2017. Use la versión más reciente de HDInsight de Azure PowerShell.
Para obtener información sobre cómo usar el nuevo HDInsight para crear un clúster, consulte Creación de clústeres basados en Linux en HDInsight mediante Azure PowerShell (https://azure.microsoft.com/en-us/documentation/articles/hdinsight-hadoop-create-linux-clusters-azure-powershell/). Para obtener información sobre cómo enviar trabajos mediante Azure PowerShell y otros enfoques, consulte Envío de trabajos de Hadoop en HDInsight (https://azure.microsoft.com/en-us/documentation/articles/hdinsight-submit-hadoop-jobs-programmatically/). Para obtener información de referencia sobre HDInsight de Azure PowerShell, consulte Cmdlets de Azure HDInsight.
El cmdlet Invoke-AzureHDInsightHiveJob envía consultas de Hive a un clúster de HDInsight, muestra el progreso de la ejecución de la consulta y obtiene los resultados de la consulta en una operación. Debe ejecutar el cmdlet Use-AzureHDInsightCluster antes de ejecutar Invoke-AzureHDInsightHiveJob para especificar el clúster de HDInsight al que enviar una consulta.
Ejemplos
Ejemplo 1: Envío de una consulta de Hive
PS C:\>Use-AzureHDInsightCluster "Cluster01" -Subscription (Get-AzureSubscription -Current).SubscriptionId
PS C:\> Invoke-AzureHDInsightHiveJob "select * from hivesampletable limit 10"El primer comando usa el cmdlet Use-AzureHDInsightCluster para especificar un clúster en la suscripción actual que se va a usar para una consulta de Hive.
El segundo comando usa el cmdlet Invoke-AzureHDInsightHiveJob para enviar la consulta de Hive.
Parámetros
-Arguments
Especifica una matriz de argumentos para un trabajo de Hadoop. 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 |
-Defines
Especifica los valores de configuración de Hadoop que se van a establecer cuando se ejecuta un trabajo.
| Tipo: | Hashtable |
| Alias: | Params |
| 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 blob de Almacenamiento de Windows Azure (WASB) a un archivo de Azure Blob Storage que contiene la consulta que se va a ejecutar. Puede usar este parámetro en lugar del parámetro Query .
| Tipo: | String |
| Alias: | QueryFile |
| 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 |
| Alias: | Name |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Profile
Especifica el perfil de Azure del que lee este cmdlet. Si no especifica un perfil, este cmdlet lee del perfil predeterminado local.
| Tipo: | AzureSMProfile |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |
-Query
Especifica una consulta de Hive.
| Tipo: | String |
| Alias: | QueryText |
| 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, incluido su código de salida y los registros de tareas.
| Tipo: | String |
| Posición: | Named |
| Valor predeterminado: | None |
| Requerido: | False |
| Aceptar entrada de canalización: | False |
| Aceptar caracteres comodín: | False |