Invoke-AzureHDInsightHiveJob
Envia consultas do Hive para um cluster HDInsight, mostra o progresso da execução da consulta e obtém os resultados da consulta em uma operação.
Observação
Os cmdlets mencionados nesta documentação são para gerenciar recursos herdados do Azure que usam APIs do Azure Service Manager (ASM). Este módulo herdado do PowerShell não é recomendado ao criar novos recursos, já que o ASM está programado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.
O módulo Az PowerShell é o módulo do PowerShell recomendado para gerenciar recursos do Azure Resource Manager (ARM) com o PowerShell.
Sintaxe
Invoke-AzureHDInsightHiveJob
[-Arguments <String[]>]
[-Defines <Hashtable>]
[-File <String>]
[-Files <String[]>]
[-JobName <String>]
[-Query <String>]
[-RunAsFileJob]
[-StatusFolder <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] Description
Esta versão do Azure PowerShell HDInsight foi preterida. Esses cmdlets serão removidos até 1º de janeiro de 2017. Use a versão mais recente do Azure PowerShell HDInsight.
Para obter informações sobre como usar o novo HDInsight para criar um cluster, consulte Criar clusters baseados em Linux no HDInsight usando o Azure PowerShell (https://azure.microsoft.com/en-us/documentation/articles/hdinsight-hadoop-create-linux-clusters-azure-powershell/). Para obter informações sobre como enviar trabalhos usando o Azure PowerShell e outras abordagens, consulte Enviar trabalhos do Hadoop no HDInsight (https://azure.microsoft.com/en-us/documentation/articles/hdinsight-submit-hadoop-jobs-programmatically/). Para obter informações de referência sobre o Azure PowerShell HDInsight, consulte Cmdlets do Azure HDInsight.
O cmdlet Invoke-AzureHDInsightHiveJob envia consultas do Hive para um cluster HDInsight, exibe o progresso da execução da consulta e obtém os resultados da consulta em uma operação. Você deve executar o cmdlet Use-AzureHDInsightCluster antes de executar Invoke-AzureHDInsightHiveJob para especificar o cluster HDInsight ao qual enviar uma consulta.
Exemplos
Exemplo 1: Enviar uma consulta do Hive
PS C:\>Use-AzureHDInsightCluster "Cluster01" -Subscription (Get-AzureSubscription -Current).SubscriptionId
PS C:\> Invoke-AzureHDInsightHiveJob "select * from hivesampletable limit 10"O primeiro comando usa o cmdlet Use-AzureHDInsightCluster para especificar um cluster na assinatura atual a ser usado para uma consulta do Hive.
O segundo comando usa o cmdlet Invoke-AzureHDInsightHiveJob para enviar a consulta do Hive.
Parâmetros
-Arguments
Especifica uma matriz de argumentos para um trabalho do Hadoop. Os argumentos são passados como argumentos de linha de comando para cada tarefa.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Defines
Especifica os valores de configuração do Hadoop a serem definidos quando um trabalho é executado.
| Tipo: | Hashtable |
| Aliases: | Params |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-File
Especifica o caminho do Blob de Armazenamento do Windows Azure (WASB) para um arquivo no armazenamento de blobs do Azure que contém a consulta a ser executada. Você pode usar esse parâmetro em vez do parâmetro Query .
| Tipo: | String |
| Aliases: | QueryFile |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Files
Especifica uma coleção de arquivos necessários para um trabalho do Hive.
| Tipo: | String[] |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-JobName
Especifica o nome de um trabalho do Hive. Se você não especificar esse parâmetro, esse cmdlet usará o valor padrão: "Hive: <first 100 characters of Query>".
| Tipo: | String |
| Aliases: | Name |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Profile
Especifica o perfil do Azure a partir do qual este cmdlet lê. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.
| Tipo: | AzureSMProfile |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-Query
Especifica uma consulta do Hive.
| Tipo: | String |
| Aliases: | QueryText |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-RunAsFileJob
Indica que esse cmdlet cria um arquivo na conta de armazenamento padrão do Azure no qual armazenar uma consulta. Esse cmdlet envia o trabalho que faz referência a esse arquivo como um script a ser executado.
Você pode usar essa funcionalidade para manipular caracteres especiais, como sinal de porcentagem (%) que falharia em um envio de trabalho por meio do Templeton, porque o Templeton interpreta uma consulta com um sinal de porcentagem como um parâmetro de URL.
| Tipo: | SwitchParameter |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |
-StatusFolder
Especifica o local da pasta que contém saídas padrão e saídas de erro para um trabalho, incluindo seu código de saída e logs de tarefas.
| Tipo: | String |
| Cargo: | Named |
| Valor padrão: | None |
| Obrigatório: | False |
| Aceitar a entrada de pipeline: | False |
| Aceitar caracteres curinga: | False |