Compartilhar via

Invoke-AzureRmHDInsightHiveJob

  • Referência
Módulo:
AzureRM.HDInsight

Envia uma consulta do Hive para um cluster HDInsight e recupera os resultados da consulta em uma operação.

Aviso

O módulo PowerShell do AzureRM foi oficialmente preterido a partir de 29 de fevereiro de 2024. Os usuários são aconselhados a migrar do AzureRM para o módulo do Az PowerShell para garantir o suporte e as atualizações contínuas.

Embora o módulo AzureRM ainda possa funcionar, ele não tem suporte ou será mantido, colocando qualquer uso contínuo a critério e risco do usuário. Consulte nossos recursos de migração para obter diretrizes sobre a transição para o módulo Az.

Sintaxe

Invoke-AzureRmHDInsightHiveJob
      [-Arguments <String[]>]
      [-Files <String[]>]
      [-StatusFolder <String>]
      [-Defines <Hashtable>]
      [-File <String>]
      [-JobName <String>]
      [-Query <String>]
      [-RunAsFileJob]
      [-DefaultContainer <String>]
      [-DefaultStorageAccountName <String>]
      [-DefaultStorageAccountKey <String>]
      [-DefaultProfile <IAzureContextContainer>]
      [<CommonParameters>]

Description

O cmdlet Invoke-AzureRmHDInsightHiveJob envia uma consulta do Hive para um cluster do Azure HDInsight e recupera os resultados da consulta em uma operação. Use o cmdlet Use-AzureRmHDInsightCluster antes de chamar Invoke-AzureRmHDInsightHiveJob para especificar qual cluster será usado para a consulta.

Exemplos

Exemplo 1: Enviar uma consulta do Hive para um cluster do Azure HDInsight

PS C:\># Primary storage account info
PS C:\> $storageAccountResourceGroupName = "Group"
PS C:\> $storageAccountName = "yourstorageacct001"
PS C:\> $storageAccountKey = (Get-AzureRmStorageAccountKey -ResourceGroupName $storageAccountResourceGroupName -Name $storageAccountName)[0].value


PS C:\> $storageContainer = "container001"

# Cluster info
PS C:\> $clusterName = "your-hadoop-001"
PS C:\> $clusterCreds = Get-Credential

# Hive job details
PS C:\> $statusFolder = "tempStatusFolder/"
PS C:\> $query = "SHOW TABLES"

PS C:\> Use-AzureRmHDInsightCluster `
            -ClusterCredential $clusterCreds `
            -ClusterName $clusterName

PS C:\> Invoke-AzureRmHDInsightHiveJob -StatusFolder $statusFolder `
            -Query $query `
            -DefaultContainer $storageAccountContainer `
            -DefaultStorageAccountName "$storageAccountName.blob.core.windows.net" `
            -DefaultStorageAccountKey $storageAccountKey

Esse comando envia a consulta SHOW TABLES para o cluster chamado your-hadoop-001.

Parâmetros

-Arguments

Especifica uma matriz de argumentos para o trabalho. 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

-DefaultContainer

Especifica o nome do contêiner padrão na conta de Armazenamento do Azure padrão que um cluster HDInsight usa.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultProfile

As credenciais, a conta, o locatário e a assinatura usadas para comunicação com o Azure

Tipo:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultStorageAccountKey

Especifica a chave de conta para a conta de armazenamento padrão que o cluster HDInsight usa.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-DefaultStorageAccountName

Especifica o nome da conta de armazenamento padrão que o cluster HDInsight usa.

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
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-File

Especifica o caminho para um arquivo no Armazenamento do Azure que contém a consulta a ser executada. Você pode usar esse parâmetro em vez do parâmetro Query .

Tipo:String
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: <primeiros 100 caracteres da Consulta>".

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

-Query

Especifica a consulta do Hive.

Tipo:String
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 na 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 lidar com 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.

Tipo:String
Cargo:Named
Valor padrão:None
Obrigatório:False
Aceitar a entrada de pipeline:False
Aceitar caracteres curinga:False

Entradas

None

Saídas

String