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

Étape 1 : Générer une URL de téléchargement

1. Connectez-vous à la console OSS et chargez le fichier de test signedget.txt dans le répertoire object-table-test/object_table_folder . Pour plus de détails, consultez la rubrique Charger des fichiers.

2. Utilisez un client local (odpscmd) ou créez un nœud SQL MaxCompute dans DataWorks afin de créer une Object Table et d'actualiser le cache des métadonnées.

   -- 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 
   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. Interrogez les métadonnées présentes dans l'Object Table.

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

   Résultat attendu :

   +---------------+------------+------------+---------------------+---------------+----------------------------------+--------------+------------+--------------------+
   | 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. Lisez les données de l'objet à l'aide de la fonction 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;

   Résultat attendu :

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

5. Interrogez l'Object Table et générez une URL pré-signée.

   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;

   Résultat attendu :

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

Étape 2 : Télécharger l'objet depuis ECS

1. Connectez-vous à la console ECS. Dans le volet de navigation de gauche, choisissez Instances & Images > Instances.

2. Dans la région Chine (Hangzhou), sélectionnez l'instance cible, cliquez sur Remote Connection, puis connectez-vous à l'instance via Workbench.

3. Dans le terminal, exécutez les commandes suivantes pour télécharger l'objet 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=****"

   Sortie :

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

Problème 1 : Le chemin de la table indiqué dans la fonction diffère du chemin de la table sous-jacente interrogée

• Message d'erreur

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

• Description du problème

  Le nom de table test_get_signed_url_from_ossxxxxxx n'existe pas ou diffère du nom de table spécifié dans l'instruction SQL.

• Solution

  Spécifiez le nom d'une Object Table existante en utilisant le format project.schema.table .

La valeur du paramètre timeToLiveSeconds n'est pas valide

• Message d'erreur

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

• Description du problème

  La valeur du paramètre timeToLiveSeconds est incorrecte. Elle doit se situer dans la plage [1, 604 800].

• Solution

  Indiquez une valeur valide pour la durée de vie (TTL).

La valeur du paramètre HttpMethod n'est pas valide

• Message d'erreur

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

• Description du problème

  La valeur du paramètre HttpMethod est incorrecte.

• Solution

  Définissez le paramètre HttpMethod sur GET ou PUT.

Le lien a expiré car la période de validité est trop courte

• Message d'erreur

  L'erreur Request has expired s'affiche lors de l'exécution de la commande curl.

• Description du problème

  L'URL signée a expiré avant d'être utilisée.

• Solution

  Définissez une valeur raisonnable pour le paramètre expiration. Évitez les valeurs excessivement longues ou courtes.

La syntaxe du modèle à trois couches n'est pas activée

• Message d'erreur

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

• Description du problème

  La syntaxe de schéma n'est pas activée. Par conséquent, le format project.schema.table ne peut pas être analysé.

• Solution

  Ajoutez la commande set odps.namespace.schema=true; avant l'instruction SQL pour activer la syntaxe de schéma.