Share via

Invoke-AzHDInsightHiveJob

  • リファレンス
モジュール:
Az.HDInsight

HIVE クエリを HDInsight クラスターに送信し、クエリ結果を 1 回の操作で取得します。

構文

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

説明

Invoke-AzHDInsightHiveJob コマンドレットは、Hive クエリを Azure HDInsight クラスターに送信し、クエリ結果を 1 回の操作で取得します。 Invoke-AzHDInsightHiveJob を呼び出してクエリに使用するクラスターを指定する前に、Use-AzHDInsightCluster コマンドレットを使用します。

例

例 1: Hive クエリを Azure HDInsight クラスターに送信する

# Primary storage account info
$storageAccountResourceGroupName = "Group"
$storageAccountName = "yourstorageacct001"
$storageAccountKey = (Get-AzStorageAccountKey -ResourceGroupName $storageAccountResourceGroupName -Name $storageAccountName)[0].value


$storageContainer = "container001"

# Cluster info
$clusterName = "your-hadoop-001"
$clusterCreds = Get-Credential

# Hive job details
$statusFolder = "tempStatusFolder/"
$query = "SHOW TABLES"

Use-AzHDInsightCluster `
            -ClusterCredential $clusterCreds `
            -ClusterName $clusterName

Invoke-AzHDInsightHiveJob -StatusFolder $statusFolder `
            -Query $query `
            -DefaultContainer $storageContainer `
            -DefaultStorageAccountName "$storageAccountName.blob.core.windows.net" `
            -DefaultStorageAccountKey $storageAccountKey

このコマンドは、クエリ SHOW TABLES を your-hadoop-001 という名前のクラスターに送信します。

パラメーター

-Arguments

ジョブの引数の配列を指定します。 引数はコマンド ライン引数として各タスクに渡されます。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultContainer

HDInsight クラスターで使用される既定の Azure Storage アカウントの既定のコンテナーの名前を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultProfile

Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション

Type:IAzureContextContainer
Aliases:AzContext, AzureRmContext, AzureCredential
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultStorageAccountKey

HDInsight クラスターで使用される既定のストレージ アカウントのアカウント キーを指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-DefaultStorageAccountName

HDInsight クラスターが使用する既定のストレージ アカウントの名前を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Defines

ジョブの実行時に設定する Hadoop 構成値を指定します。

Type:Hashtable
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-File

実行するクエリを含む Azure Storage 内のファイルへのパスを指定します。 このパラメーターは、Query パラメーターの代わりに使用できます。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Files

Hive ジョブに必要なファイルのコレクションを指定します。

Type:String[]
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-JobName

Hive ジョブの名前を指定します。 このパラメーターを指定しない場合、このコマンドレットは既定値 "Hive: <最初の 100 文字のクエリ" を使用します>。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-Query

Hive クエリを指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-RunAsFileJob

このコマンドレットが、クエリを格納する既定の Azure ストレージ アカウントにファイルを作成することを示します。 このコマンドレットは、このファイルを実行するスクリプトとして参照するジョブを送信します。 Templeton はパーセント記号を持つクエリを URL パラメーターとして解釈するため、この機能を使用して、Templeton を介したジョブの送信で失敗するパーセント記号 (%) などの特殊文字を処理できます。

Type:SwitchParameter
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

-StatusFolder

ジョブの標準出力とエラー出力を含むフォルダーの場所を指定します。

Type:String
Position:Named
Default value:None
Required:False
Accept pipeline input:False
Accept wildcard characters:False

入力

None

出力

String