次の方法で共有

Invoke-AzureRmHDInsightHiveJob

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

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

警告

AzureRM PowerShell モジュールは、2024 年 2 月 29 日に正式に非推奨になりました。 引き続きサポートを受け、更新を受け取れるようにするために、AzureRM から Az PowerShell モジュールに移行することをお勧めします。

AzureRM モジュールの機能は今後も使用できますが、メンテナンスやサポートは行われないため、引き続きの使用はユーザーの判断に委ねられ、リスクが発生することがあります。 Az モジュールへの移行に関するガイダンスについては、移行リソースを参照してください。

構文

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>]

説明

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

例

例 1: Hive クエリを 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

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

パラメーター

-Arguments

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

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultContainer

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultProfile

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

型:IAzureContextContainer
Aliases:AzureRmContext, AzureCredential
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultStorageAccountKey

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-DefaultStorageAccountName

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Defines

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

型:Hashtable
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-File

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Files

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

型:String[]
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-JobName

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-Query

Hive クエリを指定します。

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-RunAsFileJob

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

型:SwitchParameter
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

-StatusFolder

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

型:String
配置:Named
規定値:None
必須:False
パイプライン入力を受け取る:False
ワイルドカード文字を受け取る:False

入力

None

出力

String