MaxCompute：GET_SIGNED_URL_FROM_OSS

步驟一：產生下載OSS對象的URL

1. 登入OSS控制台，上傳測試資料signedget.txt至object-table-test/object_table_folder目錄下。具體操作請參見上傳檔案。

2. 使用本地用戶端（odpscmd），或在DataWorks中建立MaxCompute SQL節點，以建立Object Table並重新整理中繼資料資訊緩衝。

   -- Object Table在MaxCompute專案中支援Schema功能，開啟三層模型。 
   SET odps.namespace.schema=true;
   -- 選擇對應MaxCompute專案。 
   USE <project_name>;
   -- 選擇對應的schema。 
   USE SCHEMA <schema_name>;
   -- Object Table在MaxCompute專案中支援2.0資料類型系統。 
   SET odps.sql.type.system.odps2=true;
   -- 目前在MaxQA查詢加速中暫不支援使用。 
   SET odps.mcqa.disable=true;
   -- 建立Object Table。 
   CREATE OBJECT TABLE IF NOT EXISTS test_get_signed_url_from_oss
   WITH serdeproperties (
     'odps.properties.rolearn'='acs:ram::<uid>:role/<role_name>'
   ) 
   LOCATION 'oss://oss-cn-hangzhou-internal.aliyuncs.com/object-table-test/object_table_folder/';
   -- 重新整理表緩衝。 
   ALTER TABLE test_get_signed_url_from_oss REFRESH METADATA;

3. 查詢Object Table表中的中繼資料資訊。

   SET odps.namespace.schema=true;
   SELECT * FROM test_get_signed_url_from_oss;

   返回結果如下：

   +---------------+------------+------------+---------------------+---------------+----------------------------------+--------------+------------+--------------------+
   | key           | size       | type       | last_modified       | storage_class | etag                             | restore_info | owner_id   | owner_display_name |
   +---------------+------------+------------+---------------------+---------------+----------------------------------+--------------+------------+--------------------+
   | signedget.txt | 38         | Normal     | 2025-06-04 01:36:52 | Standard      | 96D8258845DAB51BC9B****6E61A2563 | NONE         | 13****     | 13****             |
   +---------------+------------+------------+---------------------+---------------+----------------------------------+--------------+------------+--------------------+

4. 通過函數GET_DATA_FROM_OSS讀取對象資料。

   SET odps.namespace.schema=true;
   SELECT 
     STRING(   
       GET_DATA_FROM_OSS(
         '<project_name>.<schema_name>.test_get_signed_url_from_oss',
         key
       )
     )
   FROM test_get_signed_url_from_oss;

   返回結果如下：

   +----------------------------------------+
   | _c0                                    |
   +----------------------------------------+
   | test maxcompute download files by url  |
   +----------------------------------------+

5. 查詢Object Table並產生簽名地址URL。

   SET odps.namespace.schema=true;
   SELECT GET_SIGNED_URL_FROM_OSS(  
     '<project_name>.<schema_name>.test_get_signed_url_from_oss',    
     key) 
   FROM test_get_signed_url_from_oss;

   返回結果如下：

   +------------+
   | _c0        |
   +------------+
   | http://object-table-test.oss-cn-hangzhou-internal.aliyuncs.com/object_table_folder%2Fsignedget.txt?Expires=17490****&OSSAccessKeyId=STS.****&Signature=****&security-token=**** |
   +------------+

步驟二：通過ECS伺服器下載

1. 登入ECS控制台，單擊左側導覽列執行個體與鏡像 > 執行個體。

2. 切換杭州地區，選擇目標執行個體，單擊遠端連線，通過Workbench串連ECS執行個體。

3. 在終端對話方塊執行如下指令，下載OSS對象：

   -- 切換至opt目錄下
   cd /opt
   --通過簽名URL下載對應OSS對象。
   curl -o /opt/ecs_signed.txt "http://object-table-test.oss-cn-hangzhou-internal.aliyuncs.com/object_table_folder%2Fsignedget.txt?Expires=17490****&OSSAccessKeyId=STS.****&Signature=****&security-token=****"

   返回結果：

   [xxx] opt]# curl -o /opt/ecs_signed.txt "http://object-table-test.oss-cn-hangzhou-inxxx&SAccessKeyId=STS.xxx&Signature=xxx&security-token=CAIS3gJxxx
   xxx
     % Total    % Received % Xferd  Average Speed   Time    Time     Time  Current
                                    Dload  Upload   Total   Spent    Left  Speed
   100    38  100    38    0     0    263      0 --:--:-- --:--:-- --:--:--   265
   opt]# ls
   aliyun-security  ecs_signed.txt
   [root@iZbp1al9u5z0axrqx50mptZ opt]# cat ecs_signed.txt
   test maxcompute download files by url
   xxx opt]#

問題1：函數中的表路徑和底層被查詢的表路徑不同

• 報錯資訊

  ODPS-0130071:[0,0] Semantic analysis exception - physical plan generation failed: Can't do ObjectTableTwoPhasesSplitting process (Caused by: java.lang.IllegalArgumentException: The first arg[xxx.default.test_get_signed_url_from_ossxxxxxx] of function GET_SIGNED_URL_FROM_OSS({object_table_full_name}, {object_key}, ...) can't be found in the underlying object table scans[xxx.default.test_get_signed_url_from_oss])。

• 錯誤描述

  test_get_signed_url_from_ossxxxxxx該表名不存在或者與SQL中被訪問的表名不同。

• 解決方案

  寫入真實存在且相同的Object Table表名，且用project.schema.table格式。

問題2：timeToLiveSeconds參數值不正確

• 報錯資訊

  ODPS-0121095:[1,8] Invalid argument - The parameter <timeToLiveSeconds> of the function GET_SIGNED_URL_FROM_OSS() you specified (0) is invalid, it should be in the range [1, 604800]。

• 錯誤描述

  函數中的到期時間長度（timeToLiveSeconds）參數值不正確，必須在[1, 604800]之間。

• 解決方案

  需寫入正確範圍內的到期時間長度。

問題3： HttpMethod參數值不正確

• 報錯資訊

  ODPS-0121095:[1,8] Invalid argument - The parameter <httpMethod> of the function GET_SIGNED_URL_FROM_OSS() you specified 'PU' is invalid, it can only be 'GET' or 'PUT'。

• 錯誤描述

  函數中的HttpMethod參數值不正確。

• 解決方案

  HttpMethod參數值只能為GET或者PUT。

問題4：簽章時間太短，連結已逾時

• 報錯資訊

  執行curl命令報錯Request has expired。

• 錯誤描述

  簽名URL時間太短，訪問時已經到期。

• 解決方案

  expiration參數值需要設定得合理一些，過長或過短都不建議。

問題5：未開啟三層模型文法開關

• 報錯資訊

  ODPS-0130071:[0,0] Semantic analysis exception - physical plan generation failed: Can't do ObjectTableTwoPhasesSplitting process (Caused by: java.lang.IllegalArgumentException: Invalid parameter of object table full name[str=xxx.test_get_signed_url_from_oss], which should be split up into 3 parts by '.' like '${project}.${schema}.${table}')。

• 錯誤描述

  未開啟Schema文法開關，無法識別project.schema.table文法格式。

• 解決方案

  函數SQL前需加上set odps.namespace.schema=true;開啟Schema文法開關。