Invoke-AzureHDInsightHiveJob
HIVE クエリを HDInsight クラスターに送信し、クエリ実行の進行状況を表示し、クエリ結果を 1 回の操作で取得します。
Note
このドキュメントで参照されているコマンドレットは、Azure Service Manager (ASM) API を使用するレガシ Azure リソースを管理するためのものです。 ASM の廃止が予定されているため、新しいリソースを作成する場合、このレガシ PowerShell モジュールは推奨されません。 詳細については、「Azure Service Manager の廃止」を参照してください。
Az PowerShell モジュールは、PowerShell を使用して Azure Resource Manager (ARM) リソースを管理するための推奨される 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 ジョブの引数の配列を指定します。 引数はコマンド ライン引数として各タスクに渡されます。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Defines
ジョブの実行時に設定する Hadoop 構成値を指定します。
| 型: | Hashtable |
| Aliases: | Params |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-File
実行するクエリを含む Azure BLOB ストレージ内のファイルへの Windows Azure Storage BLOB (WASB) パスを指定します。 このパラメーターは、Query パラメーターの代わりに使用できます。
| 型: | String |
| Aliases: | QueryFile |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Files
Hive ジョブに必要なファイルのコレクションを指定します。
| 型: | String[] |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-JobName
Hive ジョブの名前を指定します。 このパラメーターを指定しない場合、このコマンドレットは既定値 "Hive: <最初の 100 文字のクエリ" を使用します>。
| 型: | String |
| Aliases: | Name |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Profile
このコマンドレットが読み取る Azure プロファイルを指定します。 プロファイルを指定しない場合、このコマンドレットはローカルの既定のプロファイルから読み取ります。
| 型: | AzureSMProfile |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-Query
Hive クエリを指定します。
| 型: | String |
| Aliases: | QueryText |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-RunAsFileJob
このコマンドレットが、クエリを格納する既定の Azure ストレージ アカウントにファイルを作成することを示します。 このコマンドレットは、このファイルを実行するスクリプトとして参照するジョブを送信します。
Templeton はパーセント記号を持つクエリを URL パラメーターとして解釈するため、この機能を使用して、Templeton を介したジョブの送信で失敗するパーセント記号 (%) などの特殊文字を処理できます。
| 型: | SwitchParameter |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |
-StatusFolder
ジョブの標準出力とエラー出力を含むフォルダーの場所 (終了コードやタスク ログを含む) を指定します。
| 型: | String |
| 配置: | Named |
| 規定値: | None |
| 必須: | False |
| パイプライン入力を受け取る: | False |
| ワイルドカード文字を受け取る: | False |