New-AzureHDInsightHiveJobDefinition

Define un nuevo trabajo de Hive para un servicio de HDInsight.

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

New-AzureHDInsightHiveJobDefinition
   [-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 New-AzureHDInsightHiveJobDefinition define un trabajo de Hive para un servicio de Azure HDInsight.

Ejemplos

Ejemplo 1: Creación de una definición de trabajo de Hive

PS C:\>$HiveJobDefinition = New-AzureHDInsightHiveJobDefinition -Query $QueryString

Este comando crea una definición de trabajo de Hive que usa una cadena de consulta predefinida y, a continuación, la almacena en la variable $HiveJobDefinition.

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 para 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 a un archivo que contiene una 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 asociados a 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 del trabajo de Hive que se va a definir. Si no especifica este parámetro, se usa el nombre predeterminado: "Hive: <primeros 100 caracteres de consulta>".

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