Hologres:HoloWeb による接続とクエリ

操作手順

1. Hologres 管理コンソールにログインします。

2. 上部メニューバーの左側にあるナビゲーションウィンドウで、目的のリージョンを選択します。

3. Hologres データベースへ をクリックして、HoloWeb 開発ページに移動します。

4. Hologres インスタンスに接続します。

   1. メタデータ管理 タブで、インスタンスへの接続 をクリックします。

   2. インスタンスへの接続 ダイアログボックスで、パラメーターを設定し、OK をクリックします。

      パラメーター	説明	必須
      ネットワークタイプ	パブリックネットワーク：中国 (上海)、中国 (深セン)、中国 (北京)、中国 (杭州)、中国 (張家口)、シンガポール、中国 (香港)、マレーシア (クアラルンプール)、インドネシア (ジャカルタ)、米国 (シリコンバレー) でサポートされています。 アイコンが付いているインスタンスは パブリックネットワーク タイプを使用します。 VPC：HoloWeb にログインしているリージョンでのみサポートされます。 アイコンが付いているインスタンスは VPC タイプを使用します。このインスタンスの詳細情報は編集または削除できません。	いいえ
      インスタンス名	現在のアカウントで作成済みのインスタンスを選択します。 説明 インスタンスを購入後、HoloWeb がインスタンス情報を読み込むまで時間がかかる場合があります。インスタンス名がすぐに表示されない場合は、ドメイン名 などの接続情報を手動で設定して、対象インスタンスに接続してください。	いいえ
      名前	インスタンス名 を選択した場合、名前 フィールドには選択したインスタンス名がデフォルトで入力されます。接続名をカスタマイズすることもできます。	はい
      説明	接続に関する説明です。	いいえ
      ドメイン名	Hologres インスタンスのネットワークドメイン名です。 Hologres 管理コンソール のインスタンス詳細ページに移動し、ネットワーク情報 セクションからドメイン名を取得できます。 インスタンス名 を選択した場合、システムが対応する ドメイン名 を自動的に入力します。手動でドメイン名を入力することもできます。	はい
      ポート	Hologres インスタンスのネットワークポートです。 Hologres 管理コンソール のインスタンス詳細ページに移動し、ネットワーク情報 からポート番号を取得できます。 インスタンス名 を選択した場合、システムが対応する ポート を自動的に入力します。ポート番号を手動で入力することもできます。	はい
      ログイン方法	現在のアカウントでのパスワードレスログイン：ユーザー名やパスワードを入力せずに、現在のアカウントで直接ログインします。 アカウントでログイン：現在のアカウントまたは他のアカウントのユーザー名とパスワードを入力してログインします。	はい
      ユーザー名	このパラメーターは、ログイン方法 を アカウントとパスワードによるログイン に設定した場合にのみ必要です。 現在のアカウントの AccessKey ID です。 AccessKey ID は AccessKey 管理 から取得できます。	いいえ
      パスワード	このパラメーターは、ログイン方法 を アカウントとパスワードによるログイン に設定した場合にのみ必要です。 現在のアカウントの AccessKey Secret を入力します。	いいえ
      接続テスト	接続が成功したかどうかを確認します。 テスト成功 と表示された場合、接続は成功しています。 テスト不合格 と表示された場合、接続は失敗しています。	いいえ
      接続後にログイン	接続後にインスタンスにログインするかどうかを選択します。 Yes：インスタンスにログインされ、左側の ログイン済みインスタンス リストに表示されます。 いいえ：インスタンスは左側の 未ログインインスタンス リストに表示されます。	はい

5. (任意) データベースを作成します。

   各 Hologres インスタンスには、デフォルトの [postgres] データベースが含まれていますが、このデータベースはリソースが限られており、管理専用です。

   説明

   すでにデータベースを作成している場合は、この手順をスキップして SQL クエリを作成してください。

   1. メタデータ管理 > データベース をクリックします。

      または、メタデータ管理 ページの ログインインスタンス リストでインスタンスを右クリックし、データベースの作成 を選択します。

   2. データベースの作成 ダイアログボックスでパラメーターを設定し、OK をクリックします。

      パラメータ	説明
      インスタンス名	デフォルトで接続済みインスタンスの名前が表示されます。
      データベース名	データベースの名前を入力します。 説明 データベース名はインスタンス内で一意である必要があります。
      権限モデル	ビジネス要件に基づいて、データベースの権限ポリシーを選択します。権限ポリシーの詳細については、次のトピックをご参照ください。 SPM SLPM 標準 PostgreSQL 権限モデル
      ログイン	[はい]：データベースに自動的にログインし、すぐに使用できます。 [いいえ]：データベースを使用する前に、手動でログインする必要があります。

6. SQL クエリの作成

   SQL エディター を使用して、標準 PostgreSQL ステートメントを記述および実行します。

   1. SQL エディター ページで、 アイコンをクリックします。

      または、左側メニューで [My SQL query] を右クリックし、SQL クエリの新規作成 を選択します。「SQL ウィンドウ」をご参照ください。

   2. 新しい 一時クエリ タブで、インスタンス名 ドロップダウンリストからインスタンスを、データベース ドロップダウンリストからデータベースを選択し、SQL エディタに次のステートメントを入力して 実行 をクリックします。

      BEGIN;
      CREATE TABLE nation (
       n_nationkey bigint NOT NULL,
       n_name text NOT NULL,
       n_regionkey bigint NOT NULL,
       n_comment text NOT NULL,
      PRIMARY KEY (n_nationkey)
      );
      CALL SET_TABLE_PROPERTY('nation', 'bitmap_columns', 'n_nationkey,n_name,n_regionkey');
      CALL SET_TABLE_PROPERTY('nation', 'dictionary_encoding_columns', 'n_name,n_comment');
      CALL SET_TABLE_PROPERTY('nation', 'time_to_live_in_seconds', '31536000');
      COMMIT;
      
      INSERT INTO nation VALUES
      (11,'zRAQ', 4,'nic deposits boost atop the quickly final requests? quickly regula'),
      (22,'RUSSIA', 3  ,'requests against the platelets use never according to the quickly regular pint'),
      (2,'BRAZIL',  1 ,'y alongside of the pending deposits. carefully special packages are about the ironic forges. slyly special '),
      (5,'ETHIOPIA',  0 ,'ven packages wake quickly. regu'),
      (9,'INDONESIA', 2  ,'slyly express asymptotes. regular deposits haggle slyly. carefully ironic hockey players sleep blithely. carefull'),
      (14,'KENYA',  0  ,'pending excuses haggle furiously deposits. pending, express pinto beans wake fluffily past t'),
      (3,'CANADA',  1 ,'eas hang ironic, silent packages. slyly regular packages are furiously over the tithes. fluffily bold'),
      (4,'EGYPT', 4 ,'y above the carefully unusual theodolites. final dugouts are quickly across the furiously regular d'),
      (7,'GERMANY', 3 ,'l platelets. regular accounts x-ray: unusual, regular acco'),
      (20 ,'SAUDI ARABIA',  4 ,'ts. silent requests haggle. closely express packages sleep across the blithely');
      
      SELECT * FROM nation;

      説明

      SQL クエリでは、テーブル名とフィールド名の大文字と小文字は区別されません。テーブル名の大文字と小文字を区別して検索するには、テーブル名を二重引用符 (") で囲みます。

   3. SQL エディターページ下部の[結果 [1]] セクションに、実行結果が表示されます。

      クエリによって、nation テーブルから 10 件のレコードが返されます。これには、n_nationkey、n_name、n_regionkey、n_comment の各列が含まれており、テーブルの作成とデータの挿入操作が成功したことを確認できます。

7. 外部テーブルを作成して MaxCompute データのクエリを高速化する

   Hologres はリソースレイヤーで MaxCompute と統合されており、外部テーブルを通じてクエリの高速化が可能です。次の手順に従って、HoloWeb で外部テーブルを作成します。

   説明

   • MaxCompute プロジェクトの作成、ソーステーブルの作成、およびデータの入力が完了していることを確認してください。これは、次のいずれかの方法で実行できます。

     1. DataWorks で MaxCompute データソースをバインドし、テーブルを作成してデータを入力します。

     2. MaxCompute クライアントを使用して、テーブルを作成しデータを書き込みます。「MaxCompute クライアントの使用」をご参照ください。

   • MaxCompute および OSS データレイクの高速化機能を使用するには、HoloWeb でデータベースにログインする必要があります。

   1. メタデータ管理 > MaxCompute クエリの高速化 > 外部テーブルの作成 をクリックします。

   2. 外部テーブルの作成 ダイアログボックスでパラメーターを設定し、アクセラレーション方法を選択して、コミット をクリックします。

      プロジェクト全体

      カテゴリ	パラメーター	説明
      高速化方式	[加速方式の選択]	Hologres は、次の 3 つの高速化方法をサポートしています。 データベース高速化 部分的なアクセラレーション 単一テーブル高速化 データベース高速化 を選択します。
      MaxCompute データソース	プロジェクト名	MaxCompute プロジェクトの名前。
      	スキーマ名	MaxCompute スキーマの名前。 MaxCompute プロジェクトでスキーマが有効になっている場合は、権限を持つ任意のスキーマを指定します。スキーマのないプロジェクトでは、このパラメーターは不要です。「スキーマの操作」をご参照ください。
      ターゲットテーブルの場所	[Holo schema]	スキーマの名前。 デフォルトの public スキーマ、または作成したカスタムスキーマを選択できます。
      高度なオプション	テーブル名の競合	テーブル名の競合を処理する方法を指定します。有効な値： [Ignore, and continue creating other tables] [Update, and modify the existing table] [Report an error, and do not create the table]
      	データ型はサポートされていません。	サポートされていないデータ型を処理する方法を指定します。有効な値： [Report an error and fail the import] サポートされていないバッキングフィールドを無視、スキップ

      選択したテーブル

      カテゴリ	パラメーター	説明
      高速化方式	[加速方式の選択]	Hologres は、次の 3 つの高速化方法をサポートしています。 データベース高速化 部分的なアクセラレーション 単一テーブル高速化 部分的なアクセラレーション を選択します。
      MaxCompute データソース	プロジェクト名	MaxCompute プロジェクトの名前。
      	スキーマ名	MaxCompute スキーマの名前。 MaxCompute プロジェクトでスキーマが有効になっている場合は、権限を持つ任意のスキーマを指定します。スキーマのないプロジェクトでは、このパラメーターは不要です。「スキーマの操作」をご参照ください。
      ターゲットテーブルの場所	[Holo schema]	スキーマの名前。 デフォルトの public スキーマ、または作成したカスタムスキーマを選択できます。
      高度なオプション	テーブル名の競合	テーブル名の競合を処理する方法を指定します。有効な値： [Ignore, and continue creating other tables] [Update, and modify the existing table] [Report an error, and do not create the table]
      	データ型はサポートされていません。	サポートされていないデータ型を処理する方法を指定します。有効な値： [Report an error and fail the import] サポートされていないバッキングフィールドを無視、スキップ
      	検索	テーブル名であいまい検索を実行できます。検索結果として最大 200 テーブルが返されます。

      単一テーブル

      カテゴリ	パラメーター	説明
      高速化方式	[加速方式の選択]	Hologres は、次の 3 つの高速化方法をサポートしています。 データベース高速化 部分的なアクセラレーション 単一テーブル高速化 単一テーブル高速化 を選択します。
      MaxCompute データソース	プロジェクト名	MaxCompute プロジェクトの名前。
      	スキーマ名	MaxCompute スキーマの名前。 MaxCompute プロジェクトでスキーマが有効になっている場合は、権限を持つ任意のスキーマを指定します。スキーマのないプロジェクトでは、このパラメーターは不要です。「スキーマの操作」をご参照ください。
      	テーブル名	指定された MaxCompute スキーマ内のソーステーブルを指定します。テーブル名のプレフィックスを使用して、あいまい検索を実行できます。
      Hologres ターゲットテーブル	スキーマ	スキーマの名前。 デフォルトの public スキーマ、または作成したカスタムスキーマを選択できます。
      	テーブル名	クエリの高速化に使用する Hologres テーブルの名前を指定します。
      	ターゲットテーブルの説明	クエリの高速化に使用する Hologres テーブルの説明を指定します。

   3. 外部テーブルを作成した後、左側のナビゲーションペインで メタデータ管理 > ログインインスタンス に移動します。 外部テーブルを見つけてダブルクリックします。 表示されたエディタータブで、データプレビュー をクリックして、MaxCompute データをクエリできることを確認します。