Partilhar via


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.

Nota

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 do PowerShell herdado não é recomendado ao criar novos recursos, uma vez que o ASM está agendado para desativação. Para obter mais informações, consulte Aposentadoria do Azure Service Manager.

O módulo Az PowerShell é o módulo 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 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 a 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 para o 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 Hadoop. Os argumentos são passados como argumentos de linha de comando para cada tarefa.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Defines

Especifica os valores de configuração do Hadoop a serem definidos quando um trabalho é executado.

Tipo:Hashtable
Aliases:Params
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-File

Especifica o caminho do BLOB de Armazenamento do Windows Azure (WASB) para um arquivo no armazenamento de blob 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Files

Especifica uma coleção de arquivos necessários para um trabalho do Hive.

Tipo:String[]
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Profile

Especifica o perfil do Azure a partir do qual este cmdlet é lido. Se você não especificar um perfil, esse cmdlet será lido a partir do perfil padrão local.

Tipo:AzureSMProfile
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-Query

Especifica uma consulta do Hive.

Tipo:String
Aliases:QueryText
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False

-RunAsFileJob

Indica que esse cmdlet cria um arquivo na conta de armazenamento padrão do Azure no qual armazenar uma consulta. Este 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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais: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
Position:Named
Default value:None
Necessário:False
Aceitar entrada de pipeline:False
Aceitar carateres universais:False