TRY_TO_FILE

오류를 발생시키는 대신 NULL 을 반환하는 TO_FILE 버전입니다.

구문

다음 중 하나를 사용하십시오.

TRY_TO_FILE( <stage_name>, <relative_path> )

TRY_TO_FILE( <file_url> )

TRY_TO_FILE( <metadata> )

인자

다음을 제공하여 파일을 지정합니다.

  • stage_name 및 relative_path

  • file_url

  • 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

반환

FILE 또는 NULL.

사용법 노트

다음 경우에는 NULL 을 반환합니다.

  • 제공된 URL 이 유효하지 않습니다.

  • 파일이 사용자에게 액세스 권한이 없는 스테이징에 있습니다.

  • 제공된 메타데이터에 필수적인 FILE 필드가 포함되지 않은 경우.

예

잘못된 인자로 인해 오류가 발생하는 TO_FILE과 달리 이 상황에서는 TRY_TO_FILE이 NULL을 반환합니다. 그렇지 않으면 정확히 :doc:`TO_FILE</sql-reference/functions/to_file>`과 같이 작동합니다.

아래 예는 image.png 파일이 스테이징에 존재하지만 다른 두 파일은 존재하지 않는다는 가정하에 잘못된 파일 경로가 주어졌을 때 TRY_TO_FILE의 동작을 보여줍니다.

SELECT
    TRY_TO_FILE('@mystage/image.png'),
    TRY_TO_FILE('@mystage/incorrect_file1.jpg'),
    TRY_TO_FILE('@mystage', 'incorrect_file2.png');
Copy

결과:

+-----------------------------------------------------+---------------------------------------------+------------------------------------------------+
| TRY_TO_FILE('@MYSTAGE/IMAGE.PNG')                   | TRY_TO_FILE('@MYSTAGE/INCORRECT_FILE1.JPG') | TRY_TO_FILE('@MYSTAGE', 'INCORRECT_FILE2.PNG') |
|-----------------------------------------------------|---------------------------------------------|------------------------------------------------|
| {                                                   | NULL                                        | NULL                                           |
|   "CONTENT_TYPE": "image/png",                      |                                             |                                                |
|   "ETAG": "2859efde6e26491810f619668280a2ce",       |                                             |                                                |
|   "LAST_MODIFIED": "Thu, 18 Sep 2025 09:02:00 GMT", |                                             |                                                |
|   "RELATIVE_PATH": "image.png",                     |                                             |                                                |
|   "SIZE": 23698,                                    |                                             |                                                |
|   "STAGE": "@MYDB.MYSCHEMA.MYSTAGE"                 |                                             |                                                |
| }                                                   |                                             |                                                |
+-----------------------------------------------------+---------------------------------------------+------------------------------------------------+

유효한 입력에서 FILE 오브젝트를 만드는 방법에 대한 자세한 내용은 TO_FILE 예제 섹션을 참조하세요.

언어: 한국어