MaxCompute:GET_SIGNED_URL_FROM_OSS

STRING GET_SIGNED_URL_FROM_OSS (
  STRING <full_object_table_name>, 
  STRING <key>
  [, INT <timeToLiveSeconds>] 
  [, DATETIME <expiration>]
  [, STRING <httpMethod>]
)

Etapa 1: Gerar uma URL de download

1. Faça login no console do OSS e envie o arquivo de teste signedget.txt para o diretório object-table-test/object_table_folder. Para mais informações, consulte Upload files.

2. Use um local client (odpscmd) ou crie um MaxCompute SQL node no DataWorks para criar uma Object Table e atualizar o cache de metadados.

   -- Enable the three-layer model to support schemas in a MaxCompute project. 
   SET odps.namespace.schema=true;
   -- Select the MaxCompute project. 
   USE <project_name>;
   -- Select the schema. 
   USE SCHEMA <schema_name>;
   -- Enable the 2.0 data type system in the MaxCompute project. 
   SET odps.sql.type.system.odps2=true;
   -- This function is not supported for MaxQA query acceleration. 
   SET odps.mcqa.disable=true;
   -- Create an 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/';
   -- Refresh the table cache. 
   ALTER TABLE test_get_signed_url_from_oss REFRESH METADATA;

3. Consulte os metadados na Object Table.

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

   Saída esperada:

   +---------------+------------+------------+---------------------+---------------+----------------------------------+--------------+------------+--------------------+
   | 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. Leia os dados do objeto usando a função 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;

   Saída esperada:

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

5. Consulte a Object Table e gere uma URL pré-assinada.

   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;

   Saída esperada:

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

Etapa 2: Baixar o objeto do ECS

1. Faça login no console do ECS. No painel de navegação à esquerda, escolha Instances & Images > Instances.

2. Na região China (Hangzhou), selecione a instância desejada, clique em Remote Connection e conecte-se à instância usando o Workbench.

3. No terminal, execute os comandos a seguir para baixar o objeto do OSS:

   -- Change the directory to /opt.
   cd /opt
   -- Download the OSS object by using the pre-signed URL.
   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=****"

   Saída:

   [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]#

Problema 1: O caminho da tabela na função difere do caminho da tabela subjacente consultada

• Mensagem de erro

  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]).

• Descrição do problema

  O nome da tabela test_get_signed_url_from_ossxxxxxx não existe ou difere do nome especificado na instrução SQL.

• Solução

  Especifique o nome de uma Object Table existente no formato project.schema.table.

O valor do parâmetro timeToLiveSeconds é inválido

• Mensagem de erro

  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].

• Descrição do problema

  O valor do parâmetro timeToLiveSeconds é inválido. O valor deve estar no intervalo [1, 604800].

• Solução

  Defina um valor válido para o tempo de vida (TTL).

O valor do parâmetro HttpMethod é inválido

• Mensagem de erro

  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'.

• Descrição do problema

  O valor do parâmetro HttpMethod é inválido.

• Solução

  Defina o parâmetro HttpMethod como GET ou PUT.

O link expirou porque o período de validade é muito curto

• Mensagem de erro

  O erro Request has expired ocorre ao executar o comando curl.

• Descrição do problema

  A URL assinada expirou antes do uso.

• Solução

  Defina um valor adequado para o parâmetro expiration. Evite valores excessivamente longos ou curtos.

A sintaxe do modelo de três camadas não está ativada

• Mensagem de erro

  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}').

• Descrição do problema

  A sintaxe de schema não está ativada. Portanto, o sistema não consegue analisar o formato project.schema.table.

• Solução

  Adicione o comando set odps.namespace.schema=true; antes da instrução SQL para ativar a sintaxe de schema.