파일 함수
파일 함수 (File functions)
이 문서는 클라우드 스토리지에 스테이징된 파일에 접근할 수 있게 해주는 파일 함수들을 설명해요. 스테이지에 있는 파일의 경로나 URL을 얻거나, FILE 데이터 타입을 다루는 함수들을 안내합니다.
본문
파일 함수는 클라우드 스토리지에 스테이징된 파일에 접근할 수 있게 해줍니다.
함수 목록 (List of functions)
| 함수 이름 (Function Name) | 참고 (Notes) |
|---|---|
| 스테이지 (Stages) | |
GET_STAGE_LOCATION |
스테이지 이름을 입력으로 받아 외부 또는 내부 명명된 스테이지(named stage)의 URL을 반환 |
GET_RELATIVE_PATH |
스테이지 이름과 클라우드 스토리지의 절대 파일 경로를 입력으로 받아, 스테이지 내 위치에 상대적인 스테이징된 파일의 경로를 추출 |
GET_ABSOLUTE_PATH |
스테이지 이름과 스테이지 내 위치에 상대적인 파일 경로를 입력으로 받아 스테이징된 파일의 절대 경로를 반환 |
GET_PRESIGNED_URL |
스테이지 이름과 상대 파일 경로를 입력으로 받아 스테이징된 파일의 사전 서명된(pre-signed) URL을 생성. 이 함수를 사용해 외부 스테이지의 파일에 접근 |
BUILD_SCOPED_FILE_URL |
스테이지 이름과 상대 파일 경로를 입력으로 받아 스테이징된 파일의 스코프 지정(scoped) Snowflake 파일 URL을 생성 |
BUILD_STAGE_FILE_URL |
스테이지 이름과 상대 파일 경로를 입력으로 받아 스테이징된 파일의 Snowflake 파일 URL을 생성 |
| AI 함수 (AI Functions) | |
AI_COMPLETE |
지원되는 언어 모델을 사용해 텍스트 또는 이미지로부터 응답(완성, completion)을 생성 |
AI_PARSE_DOCUMENT |
Snowflake 스테이지의 문서에서 추출한 콘텐츠를 JSON 형식 문자열로 반환 |
AI_TRANSCRIBE |
오디오 파일에서 선택적인 타임스탬프와 화자 라벨을 포함해 텍스트로 변환(전사) |
FILE 데이터 타입용 함수 (Functions for the FILE data type)
다음 함수들은 FILE 데이터 타입과 함께 사용하기 위한 함수들이에요. 자세한 내용은 비정형 데이터 타입(Unstructured data types) 문서를 참고하세요.
| 하위 범주 (Sub-category) | 함수 (Function) |
|---|---|
| 생성자 (Constructor) | TO_FILE |
TRY_TO_FILE |
|
| 접근자 (Accessors) | FL_GET_CONTENT_TYPE |
FL_GET_ETAG |
|
FL_GET_FILE_TYPE |
|
FL_GET_LAST_MODIFIED |
|
FL_GET_RELATIVE_PATH |
|
FL_GET_SCOPED_FILE_URL |
|
FL_GET_SIZE |
|
FL_GET_STAGE |
|
FL_GET_STAGE_FILE_URL |
|
| 유틸리티 함수 (Utility Functions) | FL_IS_AUDIO |
FL_IS_COMPRESSED |
|
FL_IS_DOCUMENT |
|
FL_IS_IMAGE |
|
FL_IS_VIDEO |
사용 참고 사항 (Usage notes)
GET_PRESIGNED_URL과BUILD_SCOPED_FILE_URL은 비결정적(non-deterministic) 함수이고, 나머지는 결정적(deterministic) 함수예요.
더 알아보기 (Learn more)
- 스칼라 함수 (functions)
- 변환 함수 (functions-conversion)
- 비정형 데이터 타입 (Unstructured data types)
- 메타데이터 함수 (Metadata functions)