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 mostrados nesta documentação são usados para gerenciar recursos herdados do Azure que usam APIs de Gerenciamento de Serviços. Confira o módulo Az PowerShell para usar cmdlets a fim de gerenciar recursos do Azure Resource Manager.
Syntax
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.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Defines
Especifica os valores de configuração do Hadoop a serem definidos quando um trabalho é executado.
| Type: | Hashtable |
| Aliases: | Params |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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 .
| Type: | String |
| Aliases: | QueryFile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Files
Especifica uma coleção de arquivos necessários para um trabalho do Hive.
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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>".
| Type: | String |
| Aliases: | Name |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Query
Especifica uma consulta do Hive.
| Type: | String |
| Aliases: | QueryText |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | SwitchParameter |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | 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.
| Type: | String |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |