All Products
Search
Document Center

PolarDB:ST_SetAkId

Last Updated:Mar 28, 2026

Sets the AccessKey ID on a trajectory object. The AccessKey ID authenticates access to the Object Storage Service (OSS) bucket that stores the trajectory data.

Note

This function is not supported in later versions. Use Cold data tiered storage instead.

Syntax

trajectory ST_SetAkId(trajectory traj, text akid, bool checkvalid default true);

Parameters

ParameterDescription
trajThe trajectory object.
akidThe AccessKey ID used to access the OSS bucket.
checkvalidSpecifies whether to validate the AccessKey ID against the OSS bucket before saving it. Default value: true. If true, the function tests OSS access and returns an error if the test fails.

Description

ST_SetAkId updates the AccessKey ID stored in a trajectory object. The AccessKey ID is part of an AccessKey pair — the ID acts as a username and the AccessKey secret acts as a password — required to read trajectory data from an OSS bucket.

Examples

SELECT ST_SetAKId(traj, '<OSS_USER>') FROM trajs;

Output:

                                                                                                                                                                                                                                                   st_setakid
--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
 {"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)