GET¶
다음 Snowflake 스테이지 중 하나에서 클라이언트 컴퓨터의 로컬 디렉터리/폴더로 데이터 파일을 다운로드합니다.
명명된 내부 스테이지.
지정된 테이블의 내부 스테이지.
현재 사용자의 내부 스테이지.
일반적으로 이 명령은 COPY INTO <위치> 명령을 사용하여 테이블에서 Snowflake 스테이지로 데이터를 언로딩한 후에 실행됩니다.
참고
GET은 외부 스테이지에서의 파일 다운로드를 지원하지 않습니다. 외부 스테이지에서 파일을 다운로드하려면 클라우드 서비스에서 제공하는 유틸리티를 사용하십시오.
ODBC 드라이버 는 다음 플랫폼에 호스트된 Snowflake 계정으로 GET을 지원합니다.
Amazon Web Services(ODBC 드라이버 버전 2.17.5 이상 사용).
Google Cloud Platform(ODBC 드라이버 버전 2.21.5 이상 사용).
Microsoft Azure(ODBC 드라이버 버전 2.20.2 이상 사용).
구문¶
GET internalStage file://<path_to_file>/<filename>
[ PARALLEL = <integer> ]
[ PATTERN = '<regex_pattern>'' ]
여기서:
internalStage ::= @[<namespace>.]<int_stage_name>[/<path>] | @[<namespace>.]%<table_name>[/<path>] | @~[/<path>]
필수 매개 변수¶
internalStage
Snowflake에서 파일을 다운로딩할 원본 위치를 지정합니다.
@[namespace.]int_stage_name[/path]
파일이 지정된 명명된 내부 스테이지에서 다운로드됩니다.
@[namespace.]%table_name[/path]
파일이 지정된 테이블의 스테이지에서 다운로드됩니다.
@~[/path]
파일이 현재 사용자의 스테이지에서 다운로드됩니다.
여기서:
namespace
는 명명된 내부 스테이지 또는 테이블이 있는 데이터베이스 및/또는 스키마입니다. 데이터베이스와 스키마가 현재 세션 내에서 사용 중인 경우 이는 선택 사항입니다. 그렇지 않은 경우에는 필수입니다.path
는 파일 세트에 대한 액세스를 제한하는 클라우드 저장소 위치에 있는 파일의 선택적 경로로, 대/소문자를 구분합니다(즉, 파일 이름이 공통 문자열로 시작함). 다른 클라우드 저장소 서비스에서는 경로를 접두사 또는 폴더 라고도 합니다.path
가 지정되어 있지만 경로에 명시적으로 명명된 파일이 없는 경우, 경로의 모든 데이터 파일이 다운로드됩니다.
참고
스테이지 이름 또는 경로가 공백이나 특수 문자를 포함한 경우 이를 작은따옴표로 묶어야 합니다(예:
"my stage"
로 명명된 스테이지의 경우'@"my stage"'
).file://path_to_file
파일이 다운로드되는 클라이언트 컴퓨터의 로컬 디렉터리와 경로를 지정합니다.
- Linux/macOS
경로에 초기 슬래시를 포함해야 합니다(예:
file:///tmp/load
).디렉터리 경로 및/또는 파일 이름에 특수 문자가 포함된 경우 전체 파일 URI를 작은따옴표로 묶어야 합니다.
- Windows
경로에 드라이브와 백슬래시를 포함해야 합니다(예:
file://C:\temp\load
).디렉터리 경로 및/또는 파일 이름에 특수 문자가 포함된 경우 전체 파일 URI를 작은따옴표로 묶어야 합니다. 드라이브 및 경로 구분 기호는 둘러싼 URI 안에 있는 슬래시(
/
)입니다(예:load data
라는 디렉터리를 포함하는 Windows 경로의 경우'file://C:/temp/load data'
).
선택적 매개 변수¶
PARALLEL = integer
파일 다운로드에 사용할 스레드 수를 지정합니다. 다운로드를 위한 세분성 단위는 한 개의 파일입니다.
스레드 수를 늘리면 큰 파일을 다운로딩할 때 성능을 높일 수 있습니다.
지원되는 값:
1
(병렬 처리 없음)에서99
(파일 다운로드에 99개의 스레드 사용)까지의 모든 정수 값.기본값:
10
PATTERN = 'regex_pattern'
다운로딩할 파일을 필터링하기 위한 정규식 패턴을 지정합니다. 이 명령은 지정된
path
의 모든 파일을 나열하고 찾은 각 파일에 정규식 패턴을 적용합니다.기본값: 값 없음(지정된 스테이지의 모든 파일이 다운로드됨)
사용법 노트¶
어느 Snowflake 웹 인터페이스에서든 Worksheets
페이지에서는 이 명령을 실행할 수 없습니다. 대신 SnowSQL 클라이언트를 사용하여 데이터 파일을 다운로드하거나 특정 Snowflake 클라이언트에 대한 설명서를 참조해 이 명령에 대한 지원을 확인하십시오.
이 명령은 파일의 이름을 바꾸지 않습니다.
다운로드한 파일은 파일이 업로드되거나(PUT 사용) 테이블에서 언로딩될 때(COPY INTO <위치> 사용) 파일 암호화에 사용된 것과 같은 키를 사용하여 자동으로 암호 해독됩니다.
예¶
mytable
테이블에 대한 스테이지의 모든 파일을 (Linux 또는 macOS 환경에 있는) /tmp/data
로컬 디렉터리에 다운로드합니다.
GET @%mytable file:///tmp/data/;
현재 사용자에 대한 스테이지의 myfiles
경로에서 파일을 (Linux 또는 macOS 환경에 있는) /tmp/data
로컬 디렉터리에 다운로드합니다.
GET @~/myfiles file:///tmp/data/;