Invoke-AzureHDInsightHiveJob
HIVE クエリを HDInsight クラスターに送信し、クエリ実行の進行状況を表示し、クエリ結果を 1 回の操作で取得します。
注意
このドキュメントで参照されているコマンドレットは、Service Management API を使用するレガシ Azure リソースを管理するためのものです。 Azure Resource Manager リソースを管理するためのコマンドレットについては、Az PowerShell モジュールを参照してください。
構文
Invoke-AzureHDInsightHiveJob
[-Arguments <String[]>]
[-Defines <Hashtable>]
[-File <String>]
[-Files <String[]>]
[-JobName <String>]
[-Query <String>]
[-RunAsFileJob]
[-StatusFolder <String>]
[-Profile <AzureSMProfile>]
[<CommonParameters>] 説明
このバージョンの Azure PowerShell HDInsight は非推奨です。 これらのコマンドレットは、2017 年 1 月 1 日までに削除されます。 新しいバージョンの Azure PowerShell HDInsight を使用してください。
新しい HDInsight を使用してクラスターを作成する方法については、「Azure PowerShell () を使用して HDInsight で Linux ベースのクラスターを作成する」https://azure.microsoft.com/en-us/documentation/articles/hdinsight-hadoop-create-linux-clusters-azure-powershell/を参照してください。 Azure PowerShell やその他の方法を使用してジョブを送信する方法については、HDInsight での Hadoop ジョブの送信 (https://azure.microsoft.com/en-us/documentation/articles/hdinsight-submit-hadoop-jobs-programmatically/) に関するページを参照してください。 Azure PowerShell HDInsight のリファレンス情報については、「Azure HDInsight コマンドレット」を参照してください。
Invoke-AzureHDInsightHiveJob コマンドレットは、HIVE クエリを HDInsight クラスターに送信し、クエリ実行の進行状況を表示し、クエリ結果を 1 回の操作で取得します。 クエリを送信する HDInsight クラスターを指定するには、Invoke-AzureHDInsightHiveJob を実行する前に Use-AzureHDInsightCluster コマンドレットを実行する必要があります。
例
例 1: Hive クエリを送信する
PS C:\>Use-AzureHDInsightCluster "Cluster01" -Subscription (Get-AzureSubscription -Current).SubscriptionId
PS C:\> Invoke-AzureHDInsightHiveJob "select * from hivesampletable limit 10"最初のコマンドでは、 Use-AzureHDInsightCluster コマンドレットを使用して、Hive クエリに使用する現在のサブスクリプション内のクラスターを指定します。
2 番目のコマンドでは、 Invoke-AzureHDInsightHiveJob コマンドレットを使用して Hive クエリを送信します。
パラメーター
-Arguments
Hadoop ジョブの引数の配列を指定します。 引数はコマンド ライン引数として各タスクに渡されます。
| Type: | String[] |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Defines
ジョブの実行時に設定する Hadoop 構成値を指定します。
| Type: | Hashtable |
| Aliases: | Params |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-File
実行するクエリを含む Azure BLOB ストレージ内のファイルへの Windows Azure Storage BLOB (WASB) パスを指定します。 このパラメーターは、Query パラメーターの代わりに使用できます。
| Type: | String |
| Aliases: | QueryFile |
| 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 |
| Aliases: | Name |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
| Type: | AzureSMProfile |
| Position: | Named |
| Default value: | None |
| Required: | False |
| Accept pipeline input: | False |
| Accept wildcard characters: | False |
-Query
Hive クエリを指定します。
| Type: | String |
| Aliases: | QueryText |
| 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 |