Todos os produtos
Search
Central de documentação

ApsaraDB RDS:ST_SetStorageLocation

Última atualização: Aug 20, 2026

Use esta função para alterar o local do arquivo no Object Storage Service (OSS) que armazena os dados de um objeto de trajetória.

Nota

Esta função será descontinuada em uma versão futura. Use para obter uma experiência melhor.

Sintaxe

trajectory ST_SetStorageLocation(trajectory traj, text new_path, bool checkValid default true);

Parâmetros

Parâmetro

Descrição

traj

O objeto de trajetória.

new_path

String que especifica a pasta para armazenar os dados do objeto de trajetória indicado. O OSS suporta apenas pastas. O formato do valor do parâmetro é 'OSS://<AccessKey ID>:< AccessKey secret>@<Endpoint>/<Bucket>/<Directory>'. Os dados do objeto de trajetória especificado ficam armazenados em um arquivo .gtf na pasta definida.

checkvalid

Define se o sistema deve verificar a validade do caminho. Valor padrão: true. Quando este parâmetro é definido como true, o sistema testa a acessibilidade do diretório do OSS especificado com seu par de AccessKey. Se o teste de acesso falhar, o sistema retornará um erro.

Descrição

Esta função altera o local do arquivo que armazena os dados de um objeto de trajetória específico, mas não move o arquivo original. Antes de definir um novo local com esta função, mova a pasta que contém o arquivo de dados da trajetória no OSS para o destino desejado.

Após mover o arquivo para o novo local, novos dados de trajetória podem não ser anexados a ele. Nesse caso, o sistema retorna uma mensagem de erro contendo is not appendable. Certifique-se de carregar o último bloco de dados chamando a operação AppendObject do OSS.

Exemplos

SELECT ST_SetStorageLocation(traj, '<New Path>') FROM trajs;
                                                                                                                                                                                                                                         st_setstoragelocation                                                                                                                                                                                                                                          
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 {"trajectory":{"version":1,"type":"STPOINT","leafcount":6,"start_time":"Sat Jan 01 03:15:42 2000","end_time":"Sat Jan 01 05:16:43 2000","spatial":"LINESTRING(2 2 0,33.042158099636 36.832684322819 0,47.244002354518 47.230026333034 0,64.978971942887 60.618813472986 0,77.621717839502 78.012496630661 0,80 78 0)","timeline":["Sat Jan 01 03:15:42 2000","Sat Jan 01 03:39:54 2000","Sat Jan 01 04:04:06 2000","Sat Jan 01 04:28:18 2000","Sat Jan 01 04:52:31 2000","Sat Jan 01 05:16:43 2000"]}}
 {"trajectory":{"version":1,"type":"STPOINT","leafcount":6,"start_time":"Sat Jan 01 03:15:42 2000","end_time":"Sat Jan 01 05:16:43 2000","spatial":"LINESTRING(2 2 0,33.042158099636 36.832684322819 0,47.244002354518 47.230026333034 0,64.978971942887 60.618813472986 0,77.621717839502 78.012496630661 0,80 78 0)","timeline":["Sat Jan 01 03:15:42 2000","Sat Jan 01 03:39:54 2000","Sat Jan 01 04:04:06 2000","Sat Jan 01 04:28:18 2000","Sat Jan 01 04:52:31 2000","Sat Jan 01 05:16:43 2000"]}}
 {"trajectory":{"version":1,"type":"STPOINT","leafcount":6,"start_time":"Sat Jan 01 03:15:42 2000","end_time":"Sat Jan 01 05:16:43 2000","spatial":"LINESTRING(2 2,33.042158099636 36.832684322819,47.244002354518 47.230026333034,64.978971942887 60.618813472986,77.621717839502 78.012496630661,80 78)","timeline":["Sat Jan 01 03:15:42 2000","Sat Jan 01 03:39:54 2000","Sat Jan 01 04:04:06 2000","Sat Jan 01 04:28:18 2000","Sat Jan 01 04:52:31 2000","Sat Jan 01 05:16:43 2000"]}}
 TRAJECTORY EMPTY
(4 rows)