Invoke-AzHDInsightHiveJob
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
ジョブの引数の配列を指定します。 引数は、コマンド ライン引数として各タスクに渡されます。
型: | String[] |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultContainer
HDInsight クラスターで使用される既定の Azure Storage アカウントの既定のコンテナーの名前を指定します。
型: | String |
配置: | Named |
規定値: | None |
必須: | False |
パイプライン入力を受け取る: | False |
ワイルドカード文字を受け取る: | False |
-DefaultProfile
Azure との通信に使用される資格情報、アカウント、テナント、サブスクリプション
型: | IAzureContextContainer |
Aliases: | AzContext, 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: <Query>の最初の 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
出力
関連リンク
Azure PowerShell