- 类别:
GET_ABSOLUTE_PATH¶
使用暂存区名称和相对于暂存文件在暂存区中位置的路径作为输入,检索暂存文件的绝对路径。
语法¶
GET_ABSOLUTE_PATH( @<stage_name> , '<relative_file_path>' )
实参¶
stage_name
用于存储文件的内部或外部暂存区的名称。
备注
如果暂存区名称包含空格或特殊字符,则必须将其放在单引号内(例如,对于名为
"my stage"
的暂存区,格式为'@"my stage"'
)。relative_file_path
文件相对于其在暂存区中的位置的路径和文件名。
返回¶
文件在云存储中的绝对路径。
使用说明¶
此 SQL 函数为在暂存区上具有以下权限的任何角色返回一个值:
- 外部暂存区:
USAGE
- 内部暂存区:
READ
如果从内部暂存区下载的文件已损坏,请与暂存区创建者核实是否为该暂存区设置了
ENCRYPTION = (TYPE = 'SNOWFLAKE_SSE')
。
示例¶
检索外部暂存区中的位图格式图像文件的绝对路径:
SELECT GET_ABSOLUTE_PATH(@images_stage, 'us/yosemite/half_dome.jpg');
+------------------------------------------------------------------------------------------+
| GET_ABSOLUTE_PATH(@IMAGES_STAGE, 'US/YOSEMITE/HALF_DOME.JPG') |
+------------------------------------------------------------------------------------------+
| s3://photos/national_parks/us/yosemite/half_dome.jpg |
+------------------------------------------------------------------------------------------+