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

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

이 항목의 내용:

내부 스테이지의 유형¶

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

사용자

테이블

명명된 스테이지

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

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

파일을 Snowflake에 업로드할 때는 PUT 명령에 내부 스테이지를 반드시 지정해야 합니다.
스테이징된 파일의 테이블에 데이터를 로드하려면 COPY INTO <테이블> 명령에 동일한 스테이지를 반드시 지정해야 합니다.

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

사용자 스테이지¶

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

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

사용자 스테이지는 @~ 을 사용하여 참조됩니다. 예를 들어, LIST @~ 을 사용하여 사용자 스테이지에 파일을 나열할 수 있습니다.
명명된 스테이지와 달리 사용자 스테이지는 변경 또는 삭제가 불가능합니다.
사용자 스테이지는 파일 형식 설정 옵션을 지원하지 않습니다. 대신, 반드시 COPY INTO <테이블> 명령의 일부로 파일 형식 및 복사 옵션을 지정해야 합니다.

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

여러 사용자가 파일에 액세스해야 하는 경우.
현재 사용자에게 데이터를 로드할 테이블에 대한 INSERT 권한이 없는 경우.

테이블 스테이지¶

참고

Snowflake의 Apache Iceberg™ 테이블은 테이블 스테이지를 지원하지 않습니다.

각 테이블에는 기본적으로 파일을 저장할 수 있는 Snowflake 스테이지가 할당됩니다. 이 스테이지를 테이블 스테이지라고 합니다.

파일을 하나의 테이블로만 복사해야 하지만, 여러 사용자가 파일에 액세스할 수 있도록 하려는 경우 테이블 스테이지를 사용할 수 있습니다.

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

테이블 스테이지의 이름은 테이블과 동일합니다. 예를 들어, 이름이 mytable 인 테이블에는 이름이 @%mytable 인 스테이지가 있습니다.
테이블 스테이지는 테이블 오브젝트에 연결된 암시적 스테이지입니다. 테이블 스테이지는 별도의 데이터베이스 오브젝트가 아닙니다. 결과적으로, 테이블 스테이지에는 자체적으로 할당할 수 있는 권한이 없습니다. 여러 테이블에 파일 데이터를 복사해야 하는 경우에도 테이블 스테이지는 적합하지 않습니다.
테이블 스테이지에서 파일을 스테이징하거나, 파일을 목록으로 나열하거나, 파일을 쿼리하거나, 삭제하려면 테이블 소유자(테이블에 대해 OWNERSHIP 권한이 있는 역할이 있어야 함)여야 합니다.
명명된 스테이지와 달리, 테이블 스테이지는 변경하거나 삭제할 수 없습니다.
테이블 스테이지는 데이터를 로드(COPY 명령의 소스로 쿼리 사용)하는 동안 변환을 지원하지 않습니다.

명명된 스테이지¶

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

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

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

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

명명된 스테이지 만들기¶

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

참고

스테이지를 생성하려면 필요한 권한을 부여받거나 상속하는 역할을 사용해야 합니다. 자세한 내용은 /sql-reference/sql/create-stage`의 :ref:`label-create_stage_privileges 섹션을 참조하세요.

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

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

다음 예제는 서버 쪽 암호화를 사용하는 내부 스테이지를 만드는 예제입니다.

CREATE STAGE my_int_stage
  ENCRYPTION = (TYPE = 'SNOWFLAKE_SSE');

Copy

Python을 사용하여 네임드 스테이지 만들기¶

명명된 스테이지를 생성하려면 Snowflake Python APIs 의 StageCollection.create 메서드를 사용합니다. 자세한 내용은 스테이지 만들기 섹션을 참조하십시오.

다음 예제는 서버 쪽 암호화를 사용하는 내부 스테이지를 만드는 예제입니다.

from snowflake.core.stage import Stage, StageEncryption

my_stage = Stage(
  name="my_int_stage",
  encryption=StageEncryption(type="SNOWFLAKE_SSE")
)
root.databases["<database>"].schemas["<schema>"].stages.create(my_stage)

Copy

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

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

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

참고

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

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

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

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