로컬 파일을 위한 내부 스테이지 선택하기

스테이지는 파일의 데이터를 테이블에 로드할 수 있도록 데이터 파일이 저장되는 위치(즉, 《스테이징되는 위치》)를 지정합니다.

이 항목의 내용:

내부 스테이지의 유형

Snowflake는 다음 유형의 내부 스테이지를 지원합니다.

  • 사용자

  • 테이블

  • 명명된 스테이지

기본적으로 Snowflake의 각 사용자와 테이블에는 로드할 데이터 파일을 스테이징하기 위한 내부 스테이지가 자동으로 할당됩니다. 또한, 명명된 내부 스테이지를 생성할 수 있습니다.

데이터 로딩 프로세스의 두 단계에서 파일 스테이징 정보가 필요합니다.

  1. 파일을 Snowflake에 업로드할 때는 PUT 명령에 내부 스테이지를 반드시 지정해야 합니다.

  2. 스테이징된 파일의 테이블에 데이터를 로드하려면 COPY INTO <테이블> 명령에 동일한 스테이지를 반드시 지정해야 합니다.

특정 데이터 파일에 가장 적합한 타입의 스테이지를 고려해야 합니다. 각 옵션에는 장단점이 각각 있습니다.

사용자 스테이지

각 사용자에게는 기본적으로 파일을 저장할 수 있는 Snowflake 스테이지가 할당됩니다. 사용자 스테이지는 단일 사용자만 파일에 액세스하지만 여러 테이블에 복사해야 하는 경우에 편리한 옵션입니다.

사용자 스테이지의 특징과 제한 사항은 다음과 같습니다.

  • 사용자 스테이지는 @~ 을 사용하여 참조됩니다. 예를 들어, LIST @~ 을 사용하여 사용자 스테이지에 파일을 나열할 수 있습니다.

  • 명명된 스테이지와 달리 사용자 스테이지는 변경 또는 삭제가 불가능합니다.

  • 사용자 스테이지는 파일 형식 설정 옵션을 지원하지 않습니다. 대신, 반드시 COPY INTO <테이블> 명령의 일부로 파일 형식 및 복사 옵션을 지정해야 합니다.

이 옵션이 적합하지 않은 경우는 다음과 같습니다.

  • 여러 사용자가 파일에 액세스해야 하는 경우.

  • 현재 사용자에게 데이터를 로드할 테이블에 대한 INSERT 권한이 없는 경우.

테이블 스테이지

각 테이블에는 기본적으로 파일을 저장할 수 있는 Snowflake 스테이지가 할당됩니다. 테이블 스테이지는 여러 사용자가 파일에 액세스할 수 있어야 하고 단일 테이블에만 복사해야 하는 경우에 편리한 옵션입니다.

테이블 스테이지의 특징과 제한 사항은 다음과 같습니다.

  • 테이블 스테이지는 테이블과 이름이 같습니다. 예를 들어, mytable 이라는 테이블에는 @%mytable 로 참조되는 스테이지가 있습니다.

  • 명명된 스테이지와 달리 테이블 스테이지는 변경 또는 삭제가 불가능합니다.

  • 테이블 스테이지는 데이터를 로드하는 동안 변환을 지원하지 않습니다(즉, COPY 명령의 소스로 쿼리 사용).

테이블 스테이지는 별도의 데이터베이스 오브젝트가 아닌, 테이블 자체에 연결된 암시적 스테이지입니다. 테이블 스테이지에는 자체적으로 할당할 수 있는 권한이 없습니다. 파일을 테이블 스테이지로 스테이징하거나, 파일을 나열하거나, 스테이지에서 쿼리하거나, 삭제하려면 테이블 소유자여야 합니다(테이블에 대한 OWNERSHIP 권한이 있는 역할이 있어야 함).

이 옵션은 파일의 데이터를 여러 테이블에 복사해야 하는 경우 적합하지 않습니다.

명명된 스테이지

명명된 스테이지는 데이터를 로드하기 위한 최상의 유연성을 제공하는 데이터베이스 오브젝트입니다.

  • 스테이지에 대한 적절한 권한이 있는 사용자는 모든 테이블에 데이터를 로드할 수 있습니다.

  • 스테이지는 데이터베이스 오브젝트이므로 모든 오브젝트에 적용되는 다음과 같은 보안/액세스 규칙이 적용됩니다. 스테이지 사용 권한은 역할에서 부여하거나 취소할 수 있습니다. 또한, 스테이지의 소유권을 다른 역할로 이전할 수 있습니다.

사용자 본인만 로드하거나 단일 테이블에만 로드할 데이터 파일을 스테이징하려면 사용자 스테이지 또는 데이터를 로드할 테이블에 대한 스테이지를 사용하는 것이 좋습니다.

명명된 스테이지는 선택 사항이지만 여러 사용자 및/또는 테이블이 포함될 수 있는 일반 데이터 로드를 계획할 때 권장 됩니다. 명명된 스테이지를 생성하는 방법은 아래의 명명된 스테이지 만들기 를 참조하십시오.

명명된 스테이지 만들기

명명된 내부 스테이지는 다음과 같이 웹 인터페이스 또는 SQL을 사용하여 생성할 수 있습니다.

Classic Web Interface

Databases Databases tab » <db_이름> » Stages 을 클릭합니다.

SQL

CREATE STAGE

다음 예에서는 데이터 로드 준비하기 에서 생성된 이름이 my_csv_format 인 명명된 파일 형식 오브젝트를 참조하는 내부 스테이지를 생성합니다.

CREATE OR REPLACE STAGE my_stage
  FILE_FORMAT = my_csv_format;

참고

스테이지에 대해 명명된 파일 형식 오브젝트(또는 개별 파일 형식 옵션)를 지정하면 나중에 스테이지에서 데이터를 로드하는 데 사용되는 COPY 명령에 동일한 파일 형식 옵션을 지정할 필요가 없습니다.

다음 예에서는 명명된 파일 형식을 참조하는 대신 임시 파일 형식 옵션을 지정하는 내부 스테이지를 생성합니다. 이 스테이지의 데이터 파일에는 CSV 형식과 파이프(|) 필드 구분 기호가 있습니다. 이 스테이지가 참조될 때, COPY 명령은 데이터 파일의 첫 번째 줄을 건너뜁니다.

CREATE OR REPLACE STAGE my_stage
  file_format = (type = 'CSV' FIELD_DELIMITER = '|' SKIP_HEADER = 1);

다음 항목: 로컬 파일 시스템에서 데이터 파일 스테이징하기

맨 위로 이동