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

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

이 항목의 내용:

내부 스테이지의 유형

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

  • 사용자

  • 테이블

  • 명명된 스테이지

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

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

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

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

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

사용자 스테이지

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

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

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

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

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

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

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

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

테이블 스테이지

Each table has a Snowflake stage allocated to it by default for storing files. This stage is a convenient option if your files need to be accessible to multiple users and only need to be copied into a single table.

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

  • Table stages have the same name as the table; e.g. a table named mytable has a stage referenced as @%mytable.

  • Unlike named stages, table stages cannot be altered or dropped.

  • Table stages do not support transforming data while loading it (i.e. using a query as the source for the COPY command).

Note that a table stage is not a separate database object; rather, it is an implicit stage tied to the table itself. A table stage has no grantable privileges of its own. To stage files to a table stage, list the files, query them on the stage, or drop them, you must be the table owner (have the role with the OWNERSHIP privilege on the table).

This option is not appropriate if you need to copy the data in the files into multiple tables.

명명된 스테이지

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

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

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

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

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

명명된 스테이지 만들기

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

참고

You must use a role that is granted or inherits the USAGE privilege on the database and schema that store the stage and the CREATE STAGE privilege on the schema.

Refer to 액세스 제어 요구 사항 for CREATE STAGE.

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

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

The following example creates an internal stage that references the named file format object called my_csv_format that was created in 데이터 로드 준비하기:

CREATE OR REPLACE STAGE my_stage
  FILE_FORMAT = my_csv_format;
Copy

참고

By specifying a named file format object (or individual file format options) for the stage, it is not necessary to later specify the same file format options in the COPY command used to load data from the stage.

The following example creates an internal stage that specifies ad hoc file format options rather than referencing a named file format. Data files in this stage have a CSV format and a pipe (|) field delimiter. When this stage is referenced, the COPY command skips the first line in the data files:

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

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

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

  1. Snowsight 에 로그인합니다.

  2. Select Data » Databases.

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

  4. Select Create » Stage » Snowflake Managed.

  5. Enter a Stage Name.

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

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

    참고

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

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

  9. Create 를 선택합니다.

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

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

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