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