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

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

이 항목의 내용:

내부 스테이지의 유형¶

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

사용자

테이블

명명된 스테이지

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

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

파일을 Snowflake에 업로드할 때는 PUT 명령에 내부 스테이지를 반드시 지정해야 합니다.
스테이징된 파일의 테이블에 데이터를 로드하려면 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 를 사용하여 명명된 내부 스테이지를 만들려면 다음을 수행하십시오.

Snowsight 에 로그인합니다.
Data » Databases 를 선택합니다.
스테이지를 만들려는 데이터베이스와 스키마를 선택합니다.
Create » Stage » Snowflake Managed 를 선택합니다.
Stage Name 을 입력합니다.
원하는 경우 Directory table 을 선택 취소하십시오. 디렉터리 테이블을 사용하면 스테이지에서 파일을 볼 수 있지만 웨어하우스가 필요하므로 비용이 발생합니다. 지금은 이 옵션을 선택 취소하고 나중에 디렉터리 테이블을 활성화하도록 할 수 있습니다.
스테이지의 모든 파일에 지원되는 Encryption 의 유형을 선택합니다. 자세한 내용은 내부 스테이지의 암호화 를 참조하십시오. 스테이지를 생성한 후에는 암호화 유형을 변경할 수 없습니다.

참고

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

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

Databases » <db_이름> » Stages 을 선택합니다.

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