- カテゴリ:
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 |
+================================================================================---------------------+