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

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

이 항목의 내용:

내부 스테이지의 유형

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

  • 사용자

  • 테이블

  • 명명된 스테이지

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

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

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

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

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

사용자 스테이지

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

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

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

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

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

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

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

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

테이블 스테이지

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

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

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

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

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

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

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

명명된 스테이지

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

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

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

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

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

명명된 스테이지 만들기

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

참고

스테이지를 저장하는 데이터베이스와 스키마에 대한 USAGE 권한과 스키마에 대한 CREATE STAGE 권한이 부여되거나 이러한 권한을 상속하는 역할을 사용해야 합니다.

CREATE STAGE 에 대해서는 액세스 제어 요구 사항 섹션을 참조하십시오.

SQL을 사용하여 명명된 스테이지 만들기

SQL을 사용하여 명명된 스테이지를 만들려면 CREATE STAGE 명령을 사용하십시오.

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

CREATE OR REPLACE STAGE my_stage
  FILE_FORMAT = my_csv_format;
Copy

참고

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

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

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

Snowsight를 사용하여 명명된 스테이지 만들기

Snowsight 를 사용하여 명명된 내부 스테이지를 만들려면 다음을 수행하십시오.

  1. Snowsight 에 로그인합니다.

  2. Data » Databases 를 선택합니다.

  3. 스테이지를 만들려는 데이터베이스와 스키마를 선택합니다.

  4. Create » Stage » Snowflake Managed 를 선택합니다.

  5. Stage Name 을 입력합니다.

  6. 원하는 경우 Directory table 을 선택 취소하십시오. 디렉터리 테이블을 사용하면 스테이지에서 파일을 볼 수 있지만 웨어하우스가 필요하므로 비용이 발생합니다. 지금은 이 옵션을 선택 취소하고 나중에 디렉터리 테이블을 활성화하도록 할 수 있습니다.

  7. 스테이지의 모든 파일에 지원되는 Encryption 의 유형을 선택합니다. 자세한 내용은 내부 스테이지의 암호화 를 참조하십시오. 스테이지를 생성한 후에는 암호화 유형을 변경할 수 없습니다.

    참고

    데이터 액세스를 활성화하려면 서버 측 암호화를 선택하는 것이 좋습니다. 그렇지 않으면 스테이징된 파일은 기본적으로 클라이언트 측에서 암호화되어 다운로드 시 읽을 수 없습니다. 자세한 내용은 비정형 데이터 액세스를 위한 서버 측 암호화 섹션을 참조하십시오.

  8. 스테이지를 설명하는 필드를 채웁니다. 자세한 내용은 CREATE STAGE 섹션을 참조하십시오.

  9. Create 를 선택합니다.

Classic Console을 사용하여 명명된 스테이지 만들기

Databases 데이터베이스 탭 » <db_이름> » Stages 을 선택합니다.

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