Hologres:RAM ロール権限付与モード

コンソールと HoloWeb へのログイン

権限を付与した後、ユーザーは RAM ロールを偽装してログインし、Hologres にアクセスできます。

1. RAM ロールを使用して Hologres コンソールにログインし、Hologres インスタンスを管理します。

2. Hologres コンソールの左側のナビゲーションウィンドウで、[HoloWeb へ移動] をクリックして HoloWeb ページを開きます。その後、スキーマ設計とデータ開発を実行できます。詳細については、「HoloWeb に接続してクエリを実行する」をご参照ください。

JDBC および PSQL クライアントのログイン

Hologres V2.0 以降、Hologres は PostgreSQL プロトコルの接続オプションでセキュリティトークンを指定することをサポートしています。セキュリティトークンを使用して、Java Database Connectivity (JDBC) や PSQL などの PostgreSQL クライアントを介して RAM ロールとして Hologres にログインし、アクセスできます。

Hologres にアクセスする前に、次の操作が完了していることを確認してください。

• RAM ロールを Hologres インスタンスに追加し、権限を付与しました。詳細については、「ステップ 2: RAM ロールを Hologres インスタンスに追加して権限を付与する」をご参照ください。

• RAM で AssumeRole API 操作を呼び出して、STS トークントライアド (AccessKeyId、AccessKeySecret、および SecurityToken) を取得しました。詳細については、「STS SDK 呼び出しの例」をご参照ください。以下は、STS トークン情報のサンプルです。

  "Credentials": {
      "SecurityToken": "CAISuwJ1q6Ft5B2yu****KiAA",
      "AccessKeyId": "STS.NTKaenSkmLhG4HpM5****76UV",
      "AccessKeySecret": "6itECZnhbG2RU6ktTSBSd6JxeLHKPWyBt****SS62",
      "Expiration": "2025-02-21T03:47:07Z"
    }

操作が完了したことを確認した後、次の方法で Hologres に接続してアクセスできます。

• JDBC Java 接続方法: 詳細については、「JDBC を使用して Hologres に接続する」をご参照ください。

  • サンプルコード 1: PostgreSQL JDBC ドライバーが提供する PGProperty クラスのプロパティを使用して、STS トークントライアドをロードして ID 検証を完了します。

    import org.postgresql.PGProperty;
    import java.sql.*;
    import java.io.IOException;
    import java.util.Properties;
    
    public class JdbcLinkHologres1 {
        public static void main(String[] args) throws IOException, ClassNotFoundException, SQLException {
             // この例では、AccessKey ID と AccessKey Secret を環境変数に保存する方法を示します。必要に応じて、設定ファイルに保存することもできます。
    	// コードに AccessKey ID と AccessKey Secret をハードコーディングしないことを強く推奨します。これにより、キーが漏洩する可能性があります。
            String accessKeyId = "ALIBABA_CLOUD_ACCESS_KEY_ID";
            String accessKeySecret = "ALIBABA_CLOUD_ACCESS_KEY_SECRET";
            String securityToken = "<SecurityToken>";
            String url = "jdbc:postgresql://<host>:<port>/<database>";
    
            Properties props = new Properties();
            PGProperty.USER.set(props, accessKeyId);
            PGProperty.PASSWORD.set(props, accessKeySecret);
            PGProperty.OPTIONS.set(props, "sts_token=" + securityToken);
    
            Class.forName("org.postgresql.Driver");
            Connection connection = DriverManager.getConnection(url, props);
    
            Statement statement = connection.createStatement();
            ResultSet resultSet = statement.executeQuery("SELECT * FROM tabletest");
            // resultSet を処理します
            while (resultSet.next()) {
                System.out.println("Result: " + resultSet.getInt(1));
                System.out.println("Result: " +  resultSet.getString(2));
            }
        }
    }

  • サンプルコード 2: SecurityToken 情報を URL エンコードし、JDBC URL に追加します。次に、ドライバークラスを介して Hologres 接続を取得するときに、AccessKeyId と AccessKeySecret をロードして ID 検証を行います。

    import java.net.URLEncoder;
    import java.sql.*;
    import java.io.IOException;
    
    public class JdbcLinkHologres2 {
        public static void main(String[] args) throws IOException, ClassNotFoundException, SQLException {
            // この例では、AccessKey ID と AccessKey Secret を環境変数に保存する方法を示します。必要に応じて、設定ファイルに保存することもできます。
    	// コードに AccessKey ID と AccessKey Secret をハードコーディングしないことを強く推奨します。これにより、キーが漏洩する可能性があります。
            String accessKeyId = "ALIBABA_CLOUD_ACCESS_KEY_ID";
            String accessKeySecret = "ALIBABA_CLOUD_ACCESS_KEY_SECRET";
            String securityToken = "<SecurityToken>";
                        
            String url = "jdbc:postgresql://<host>:<port>/<database>";
            String urlWithOptions = url + "?options=sts_token=" + URLEncoder.encode(securityToken, "UTF-8");
    
            Class.forName("org.postgresql.Driver");
            Connection connection = DriverManager.getConnection(urlWithOptions, accessKeyId, accessKeySecret);
    
            Statement statement = connection.createStatement();
            ResultSet resultSet = statement.executeQuery("SELECT * FROM tabletest");
    
            // resultSet を処理します
            while (resultSet.next()) {
                System.out.println("Result: " + resultSet.getInt(1));
                System.out.println("Result: " +  resultSet.getString(2));
            }
        }
    }

• PSQL クライアント接続方法: 以下は Linux システムのステートメントです。詳細については、「PSQL クライアントを使用して Hologres に接続する」をご参照ください。

  PGUSER=<AccessKeyId> PGPASSWORD=<AccessKeySecret> PGOPTIONS="sts_token=<SecurityToken>" psql -h <host> -p <port> -d <database>

よくある質問

RAM ロールとしてログインしたときにエラー password authentication failed for user "<AccessKeyId>" が報告された場合はどうすればよいですか？

このエラーは、AccessKeyId、AccessKeySecret、またはセキュリティトークンが正しくないか、ログインユーザーが Hologres インスタンスで作成されていない可能性があることを示します。次のチェックを順番に実行することをお勧めします。

1. ログインユーザーがインスタンスに存在するかどうかを確認します。存在しない場合は、RAM ロールをインスタンスに追加します。詳細については、「ステップ 2: RAM ロールを Hologres インスタンスに追加して権限を付与する」をご参照ください。

2. セキュリティトークンが正しく渡されているかどうかを確認します。URL を介して渡される場合は、URLEncoder.encode を使用して処理する必要があります。

3. AccessKeyId、AccessKeySecret、およびセキュリティトークンが正しいかどうかを確認します。