Hologres:HoloWeb への接続

操作手順

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

2. 上部メニューバー左側のナビゲーションウィンドウから、ご利用のリージョンを選択します。

3. Go to HoloWeb をクリックして、HoloWeb 開発ページに移動できます。

4. Hologres インスタンスにログインします。

   1. Metadata Management タブで、Instances をクリックします。

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

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

5. （オプション）データベースを作成します。

   Hologres インスタンスを有効化すると、システムが自動的に postgres データベースを作成します。このデータベースには最小限のリソースが割り当てられており、管理タスク専用です。ビジネスサービスを開発するには、新しいデータベースを作成してください。

   説明

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

   1. Metadata Management > データベース をクリックします。

      あるいは、Metadata Management ページの ログイン済みインスタンス リストで、対象の接続を右クリックし、Create Database を選択します。

   2. Create Database ダイアログボックスでパラメーターを設定し、OK をクリックします。

      パラメーター	説明
      インスタンス名	現在のデータベースが存在するログイン済みインスタンスの名前がデフォルトで表示されます。
      データベース名	現在のデータベースに名前を付けます。 説明 設定したデータベース名は一意である必要があります。
      アクセスポリシー	必要に応じてデータベースの権限を設定します。アクセスポリシーの詳細については、以下をご参照ください： SPM SLPM 標準権限モデル
      即時ログイン	はい: ログイン後、作成されたデータベースを直接使用します。 いいえ：データベースを使用する前にログインします。

6. SQL クエリを作成します。

   Hologres インスタンスに接続後、SQL Editor モジュールで、標準の PostgreSQL 構文を使用して開発を行います。

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

      あるいは、左側のナビゲーションウィンドウで My SQL Queries を右クリックし、Create SQL Query を選択します。詳細については、「SQL ウィンドウ」をご参照ください。

   2. 新しい Ad-hoc Query ページで、作成済みの Instance Name および データベース を選択します。その後、以下のサンプルステートメントを SQL エディターに入力し、Run をクリックします。

      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] セクションで、ステートメントの実行結果を確認します。

      

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

   Hologres は MaxCompute とシームレスに連携し、外部テーブルを作成することで MaxCompute データのクエリを高速化できます。以下の手順では、HoloWeb の可視化機能を用いた外部テーブルの作成方法について説明します。

   説明

   • 事前に MaxCompute プロジェクトを作成 し、ソーステーブルを作成してデータを書き込んでいることを確認してください。これらの操作は、以下のいずれかの方法で実行できます：

     1. DataWorks プラットフォームを使用します。MaxCompute データソースをアタッチし、その後テーブルを作成してデータを書き込みます。

     2. ローカルクライアントを用いた MaxCompute へのアクセス を使用して、テーブルを作成し、データを書き込みます。

   • MaxCompute および OSS データレイクのデータクエリ高速化機能を利用するには、あらかじめ HoloWeb でデータベースにログインしておく必要があります。

   1. Metadata Management > MaxCompute クエリの高速化 > Create Foreign Table をクリックします。

   2. Create Foreign Table ダイアログボックスでパラメーターを設定し、必要に応じて高速化モードを選択して、Submit をクリックします。

      全データベース高速化

      カテゴリ	パラメーター	説明
      Acceleration Method	Select an acceleration method.	Hologres では、以下の 3 つの高速化モードをサポートしています： Entire Project Selected Tables Single Table Entire Project を選択します。
      MaxCompute データソース	Project Name	MaxCompute プロジェクトの名前です。
      	Schema Name	MaxCompute スキーマの名前です。 スキーマが有効化されている MaxCompute プロジェクトの場合、権限を持つ任意のスキーマ名を指定できます。スキーマが無効化されているプロジェクトでは、このパラメーターを設定する必要はありません。スキーマの詳細については、「スキーマ操作」をご参照ください。
      Destination Table Position	Holo スキーマ	パターンの名前。 デフォルトの public スキーマまたは新規スキーマを選択できます。
      Advanced Settings	Processing Rule for Table Name Conflicts	テーブル名の競合を解決するための 3 つの方法： 無視して他のテーブルの作成を継続 同名のテーブルを更新・変更 エラーを報告し、テーブルの再作成を行わない
      	Processing Rule for Unsupported Data Types	以下の 2 つのデータ型は処理がサポートされていません： エラーを報告し、インポートを失敗させる Ignore and Skip Table of Unsupported Fields

      部分高速化

      カテゴリ	パラメーター	説明
      Acceleration Method	Select an acceleration method.	Hologres では、以下の 3 つの高速化モードをサポートしています： Entire Project Selected Tables Single Table Selected Tables を選択します。
      MaxCompute データソース	Project Name	MaxCompute プロジェクトの名前です。
      	Schema Name	MaxCompute スキーマの名前です。 スキーマが有効化されている MaxCompute プロジェクトの場合、権限を持つ任意のスキーマ名を指定できます。スキーマが無効化されているプロジェクトでは、このパラメーターを設定する必要はありません。スキーマの詳細については、「スキーマ操作」をご参照ください。
      Destination Table Position	Holo スキーマ	スキーマ名です。 デフォルトの public スキーマまたは新規スキーマを選択できます。
      Advanced Settings	Processing Rule for Table Name Conflicts	テーブル名の競合を解決するための 3 つの方法： 無視して他のテーブルの作成を継続 同名のテーブルを更新・変更 重複を作成せずにエラーを報告
      	Processing Rule for Unsupported Data Types	処理がサポートされていない 2 つのデータ型： エラーを報告し、インポートを失敗させる Ignore and Skip Table of Unsupported Fields
      	Search	テーブル名によるあいまい検索を実行します。最大 200 件のテーブルを表示できます。

      単一テーブル高速化

      カテゴリ	パラメーター	説明
      Acceleration Method	Select an acceleration method.	Hologres では、以下の 3 つの高速化モードをサポートしています： Entire Project Selected Tables Single Table Single Table を選択します。
      MaxCompute データソース	Project Name	MaxCompute プロジェクトの名前です。
      	Schema Name	MaxCompute スキーマの名前です。 スキーマが有効化されている MaxCompute プロジェクトの場合、権限を持つ任意のスキーマ名を指定できます。スキーマが無効化されているプロジェクトでは、このパラメーターを設定する必要はありません。スキーマの詳細については、「スキーマ操作」をご参照ください。
      	Table Name	MaxCompute の対応するスキーマ内のデータテーブルです。テーブル名のプレフィックスに基づくあいまい検索が可能です。
      Destination Hologres Table	Schema	スキーマ名です。 デフォルトの public スキーマまたは新規スキーマを選択できます。
      	Table Name	高速化対象となる Hologres の単一テーブルの名前です。
      	Destination Table Description	高速化対象となる Hologres の単一テーブルの説明です。

   3. 外部テーブルの作成後、左側のナビゲーションウィンドウで Metadata Management > ログイン済みインスタンス を選択します。宛先の外部テーブルをダブルクリックし、表示されたページで Data Preview をクリックして、MaxCompute データのクエリを高速化します。