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