TRY_TO_FILE¶

语法¶

使用下列之一：

TRY_TO_FILE( <stage_name>, <relative_path> )

TRY_TO_FILE( <file_url> )

TRY_TO_FILE( <metadata> )

实参¶

stage_name

文件所在暂存区的名称，以 '@stage_name' 形式的字符串表示。

relative_path

暂存区上文件的路径，由 stage_name 以字符串形式指定。

file_url

字符串形式的有效暂存区或作用域文件 URL。

metadata

包含所需 FILE 元数据的 OBJECT。FILE 必须有 CONTENT_TYPE、SIZE、ETAG 和 LAST_MODIFIED 字段。它还必须通过以下方式之一指定文件的位置：

• STAGE 和 RELATIVE_PATH

• STAGE_FILE_URL

• SCOPED_FILE_URL

返回¶

:doc:` FILE </sql-reference/data-types-unstructured>` 或 NULL。

使用说明¶

在以下情况下返回 NULL：

• 提供的 URL 无效。

• 该文件位于用户无权访问的暂存区。

• 提供的元数据不包含必填 FILE 字段。

示例¶

请参阅 TO_FILE。