HDInsight .NET SDK を使用して Apache Hive クエリを実行する

HDInsight .NET SDK を使用して Apache Hive クエリを送信する方法について説明します。 Hive テーブルを表示するための Hive クエリを送信し、結果を表示する C# プログラムを作成します。

前提条件

この記事の操作を始める前に、以下を用意する必要があります。

• HDInsight 上の Apache Spark クラスター。 詳細については、HDInsight での Linux ベース Hadoop の使用に関するページを参照してください。

  重要

  2017 年 9 月 15 日の時点で、HDInsight .NET SDK でサポートされているのは、Azure ストレージ アカウントから Hive クエリの結果を返すことのみです。 プライマリ ストレージとして Azure Data Lake Storage を使用している HDInsight クラスターでこの例を使用する場合、.NET SDK を使用して検索結果を取得することはできません。

• Visual Studio 2013 以降。 少なくとも [.NET デスクトップ開発] ワークロードがインストールされている必要があります。

Hive クエリを実行する

HDInsight .NET SDK は、.NET から HDInsight クラスターを簡単に操作できる .NET クライアント ライブラリを提供します。

1. Visual Studio で、C# コンソール アプリケーションを作成します。

2. NuGet パッケージ マネージャー コンソールから、次のコマンドを実行します。

   Install-Package Microsoft.Azure.Management.HDInsight.Job
   

3. 次のコードを編集して、変数 ExistingClusterName, ExistingClusterUsername, ExistingClusterPassword,DefaultStorageAccountName,DefaultStorageAccountKey,DefaultStorageContainerName の値を初期化します。 その後、変更されたコードを Visual Studio の Program.cs の内容全体として使用します。

   using System.Collections.Generic;
   using System.IO;
   using System.Text;
   using System.Threading;
   using Microsoft.Azure.Management.HDInsight.Job;
   using Microsoft.Azure.Management.HDInsight.Job.Models;
   using Hyak.Common;
   
   namespace SubmitHDInsightJobDotNet
   {
       class Program
       {
           private static HDInsightJobManagementClient _hdiJobManagementClient;
   
           private const string ExistingClusterName = "<Your HDInsight Cluster Name>";
           private const string ExistingClusterUsername = "<Cluster Username>";
           private const string ExistingClusterPassword = "<Cluster User Password>";
   
           // Only Azure Storage accounts are supported by the SDK
           private const string DefaultStorageAccountName = "<Default Storage Account Name>";
           private const string DefaultStorageAccountKey = "<Default Storage Account Key>";
           private const string DefaultStorageContainerName = "<Default Blob Container Name>";
   
           private const string ExistingClusterUri = ExistingClusterName + ".azurehdinsight.net";
   
           static void Main(string[] args)
           {
               System.Console.WriteLine("The application is running ...");
   
               var clusterCredentials = new BasicAuthenticationCloudCredentials { Username = ExistingClusterUsername, Password = ExistingClusterPassword };
               _hdiJobManagementClient = new HDInsightJobManagementClient(ExistingClusterUri, clusterCredentials);
   
               SubmitHiveJob();
   
               System.Console.WriteLine("Press ENTER to continue ...");
               System.Console.ReadLine();
           }
   
           private static void SubmitHiveJob()
           {
               Dictionary<string, string> defines = new Dictionary<string, string> { { "hive.execution.engine", "tez" }, { "hive.exec.reducers.max", "1" } };
               List<string> args = new List<string> { { "argA" }, { "argB" } };
               var parameters = new HiveJobSubmissionParameters
               {
                   Query = "SHOW TABLES",
                   Defines = defines,
                   Arguments = args
               };
   
               System.Console.WriteLine("Submitting the Hive job to the cluster...");
               var jobResponse = _hdiJobManagementClient.JobManagement.SubmitHiveJob(parameters);
               var jobId = jobResponse.JobSubmissionJsonResponse.Id;
               System.Console.WriteLine("Response status code is " + jobResponse.StatusCode);
               System.Console.WriteLine("JobId is " + jobId);
   
               System.Console.WriteLine("Waiting for the job completion ...");
   
               // Wait for job completion
               var jobDetail = _hdiJobManagementClient.JobManagement.GetJob(jobId).JobDetail;
               while (!jobDetail.Status.JobComplete)
               {
                   Thread.Sleep(1000);
                   jobDetail = _hdiJobManagementClient.JobManagement.GetJob(jobId).JobDetail;
               }
   
               // Get job output
               var storageAccess = new AzureStorageAccess(DefaultStorageAccountName, DefaultStorageAccountKey,
                   DefaultStorageContainerName);
               var output = (jobDetail.ExitValue == 0)
                   ? _hdiJobManagementClient.JobManagement.GetJobOutput(jobId, storageAccess) // fetch stdout output in case of success
                   : _hdiJobManagementClient.JobManagement.GetJobErrorLogs(jobId, storageAccess); // fetch stderr output in case of failure
   
               System.Console.WriteLine("Job output is: ");
   
               using (var reader = new StreamReader(output, Encoding.UTF8))
               {
                   string value = reader.ReadToEnd();
                   System.Console.WriteLine(value);
               }
           }
       }
   }
   

4. F5 キーを押してアプリケーションを実行します。

アプリケーションの出力は次のようになります。

次のステップ

この記事では、HDInsight .NET SDK を使用して Apache Hive クエリを送信する方法について説明しました。 詳細については、以下の記事をお読みください。

• Azure HDInsight の概要
• HDInsight で Apache Hadoop クラスターを作成する
• HDInsight .NET SDK リファレンス
• HDInsight での Apache Sqoop の使用
• 非対話型認証 .NET HDInsight アプリケーションを作成する