Hologres：Hologres RAM角色授權模式

管控台登入和HoloWeb登入

當您完成授權之後，使用者就可以扮演user-role角色登入並使用Hologres。

1. 使用RAM角色，登入Hologres管理主控台，對Hologres執行個體進行管控。

2. 在Hologres控制台頁面，單擊左側導覽列前往HoloWeb，進入HoloWeb頁面，進行Hologres結構設計和資料開發。具體操作請參見串連HoloWeb並執行查詢。

JDBC和PSQL用戶端登入

從Hologres V2.0版本開始，Hologres支援在PostgreSQL協議的串連選項中指定Security Token。您可以憑藉Security Token，通過PostgreSQL用戶端，如JDBC或PSQL，實現RAM角色登入訪問Hologres。

在訪問Hologres之前，您需要先確認已完成下述兩項操作：

• 您已添加RAM角色至Hologres執行個體並授權。詳情請參見步驟二：添加RAM角色至Hologres執行個體並授權。

• 您已調用存取控制中的API（AssumeRole - 擷取扮演角色的臨時身份憑證）擷取STS Token三元組（AccessKeyId、AccessKeySecret和SecurityToken）。具體操作步驟，詳情請參見STS SDK調用樣本。STS Token樣本資訊如下：

  "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 Driver內建的PGProperty類的屬性來載入STS Token三元組完成身份校正。

    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和AccessKeySecret儲存在環境變數為例說明。您也可以根據業務需要，儲存到設定檔裡
    	// 強烈建議不要把AccessKey和AccessKeySecret儲存到代碼裡，會存在密鑰泄漏風險
            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");
            // Process the 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進行身分識別驗證。

    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和AccessKeySecret儲存在環境變數為例說明。您也可以根據業務需要，儲存到設定檔裡
    	// 強烈建議不要把AccessKey和AccessKeySecret儲存到代碼裡，會存在密鑰泄漏風險
            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");
    
            // Process the 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錯誤、Security Token錯誤，或當前登入的使用者尚未在Hologres執行個體中建立。建議按照以下順序進行排查：

1. 檢查執行個體內是否存在當前正在登入的使用者。若不存在，可將RAM角色新增至該執行個體。詳情請參見步驟二：添加RAM角色至Hologres執行個體並授權。

2. 檢查Security Token傳遞方式是否正確，當通過URL進行傳遞時，需要經過URLEncoder.encode處理。

3. 檢查AccessKeyId、AccessKeySecret和Security Token是否正確無誤。