Snowsight를 사용하여 파일 스테이징하기

Snowsight 를 사용하면 SQL을 작성하지 않고도 명명된 스테이지를 만들고 관리할 수 있습니다. 또한 명명된 내부 스테이지로 파일을 업로드하여 파일을 보거나 Python 워크시트에서 파일을 참조하거나 파일의 데이터를 테이블로 로드 할 수도 있습니다.

Snowsight 를 사용하여 파일을 사용자 스테이지 또는 테이블 스테이지로 업로드할 수 없습니다. 스테이지에 대한 자세한 내용은 데이터 로딩 개요 섹션을 참조하십시오.

이 항목의 내용:

스테이지 만들기

Snowsight 를 사용하여 명명된 내부 또는 외부 스테이지를 생성할 수 있습니다.

참고

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

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

명명된 내부 스테이지 만들기

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 를 선택합니다.

명명된 외부 스테이지 만들기

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

  1. Snowsight 에 로그인합니다.

  2. 탐색 메뉴에서 Data » Databases 를 선택합니다.

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

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

  5. 파일이 있는 지원되는 클라우드 저장소 서비스를 선택합니다.

  6. Stage Name 을 입력합니다.

  7. 외부 클라우드 저장소 위치의 URL 을 입력합니다.

  8. 외부 저장소가 공용이 아닌 경우 Authentication 을 활성화하고 세부 정보를 입력합니다. 자세한 내용은 CREATE STAGE 섹션을 참조하십시오.

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

    Directory table 을 활성화하는 경우 원한다면 Enable auto-refresh 를 선택하고 이벤트 알림 또는 알림 통합을 선택하여 파일이 추가되거나 제거될 때 디렉터리 테이블을 자동으로 새로 고칩니다. 자세한 내용은 자동화된 디렉터리 테이블 메타데이터 새로 고침 을 참조하십시오.

  10. 파일이 암호화된 경우 Encryption 을 활성화하고 세부 정보를 입력합니다.

  11. 선택적으로, SQL Preview 를 확장하여 생성된 SQL 문을 봅니다. AUTO_REFRESH와 같은 스테이지에 대한 추가 옵션을 지정하려면 워크시트에서 이 SQL 미리 보기를 열 수 있습니다.

  12. Create 를 선택합니다.

스테이지에 파일 업로드하기

Snowsight 를 사용하여 명명된 내부 스테이지에 파일을 업로드할 수 있습니다.

Amazon S3, Microsoft Azure 또는 Google Cloud Storage와 같은 서비스의 외부 스테이지에 파일을 업로드하려면 해당 클라우드 서비스용 도구를 사용하십시오.

명명된 내부 스테이지에 파일 업로드하기

참고

최대 파일 크기는 250MB입니다.

데이터베이스와 스키마에 대한 USAGE 권한과 이러한 단계를 수행할 스테이지에 대한 WRITE 권한이 부여되거나 이러한 권한을 상속하는 역할을 사용해야 합니다. 스테이지 권한 섹션을 참조하십시오.

스테이지에 파일을 업로드하려면 다음을 수행하십시오.

  1. Snowsight 에 로그인합니다.

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

  3. 스테이지를 생성한 데이터베이스 스키마를 선택하고 스테이지를 선택합니다.

  4. + Files 를 선택하여 스테이지에 파일을 업로드합니다.

  5. 이때 나타나는 Upload Your Files 대화 상자에서 업로드하려는 파일을 선택합니다. 한 번에 여러 파일을 업로드할 수 있습니다.

  6. 필요에 따라 스테이지 내에 파일을 저장할 경로를 선택하거나 만듭니다.

  7. Upload 를 선택합니다.

스테이지에 파일을 업로드한 후 파일에 따라 다음 작업 중 하나를 수행할 수 있습니다.

스테이징된 파일 보기

Snowsight 를 사용하여 스테이징된 파일을 볼 수 있습니다. 내부 및 외부 스테이지에서 모두 파일을 볼 수 있습니다.

참고

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

  1. Snowsight 에 로그인합니다.

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

  3. 스테이지를 포함하는 데이터베이스와 스키마를 선택합니다.

  4. Stages 를 선택하고 파일을 보려는 스테이지를 선택합니다.

  5. 메시지가 표시되면 Enable Directory Table 을 선택하여 스테이지에 대한 디렉터리 테이블을 활성화함으로써 파일을 볼 수 있도록 합니다.

  6. 메시지가 표시되면 디렉터리 테이블을 새로 고칠 웨어하우스를 선택합니다.

스테이지의 디렉터리 테이블을 새로 고치려면 새로 고침 아이콘을 선택하십시오.

스테이징된 파일 관리하기

Snowsight 를 사용하여 스테이징된 파일에 대해 다음 작업을 수행할 수 있습니다.

내부 스테이지에 있는 파일의 경우 다음 작업을 수행할 수도 있습니다.

  • 스테이지에서 파일을 다운로드하려면 추가 옵션 » Download 를 선택합니다.

  • 스테이지에서 파일을 제거하려면 추가 옵션 » Remove 를 선택합니다.

참고

외부 스테이지에서 파일을 다운로드하려면 Snowsight에서 스테이징된 파일 다운로드하기 섹션을 참조하십시오.

스테이지 관리하기

Snowsight 에서 스테이지를 관리하려면 다음을 수행하십시오.

참고

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

  1. Snowsight 에 로그인합니다.

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

  3. 스테이지를 포함하는 데이터베이스와 스키마를 선택합니다.

  4. Stages 를 선택하고 스테이지를 선택합니다.

  5. Stage Details 를 선택합니다.

다음과 같은 방법으로 스테이지를 관리할 수 있습니다.

  • 속성을 편집하거나 스테이지 오브젝트의 디렉터리 테이블을 활성화하려면 추가 옵션 » Edit 를 선택하십시오.

  • 스테이지를 복제하려면 추가 옵션 » Clone 을 선택하십시오.

  • 스테이지를 삭제하거나 제거하려면 추가 옵션 » Drop 을 선택하십시오.

  • 스테이지의 OWNERSHIP 권한을 다른 역할로 이전하려면 추가 옵션 » Transfer Ownership 을 선택하십시오.

스테이지에 대한 권한을 관리하려는 경우 Privileges 섹션을 사용하여 권한을 보고 부여하고 철회할 수 있습니다.

문제 해결

파일이 외부 스테이지에 표시되지 않음

외부 스테이지에 활성화된 디렉터리 테이블이 없거나 외부 저장소 위치에 대한 정보가 잘못된 경우 이 문제가 발생할 수 있습니다.

이 문제를 해결하려면 다음을 시도해 보십시오.

  • 스테이지 소유자가 스테이지에서 디렉터리 테이블 을 활성화했는지 확인합니다.

  • 디렉터리 테이블이 새로 고쳐졌는지 다시 확인합니다. 디렉터리 테이블을 새로 고치려면 Snowsight 에서 스테이지를 선택한 다음 새로 고침 아이콘을 선택합니다.

  • 클라우드 공급자 URL이 올바른지 확인합니다. URL에 하위 경로가 포함된 경우 후행 슬래시가 있는지 확인합니다.

파일 업로드 버튼을 사용할 수 없음(비활성)

내부 스테이지에 파일을 업로드하는 데 필요한 권한이 없거나 다른 업로드가 진행 중인 경우 이 문제가 발생할 수 있습니다.

이 문제를 해결하려면 다음을 시도해 보십시오.

  • 내부 스테이지를 선택했는지 확인하십시오.

  • 데이터베이스와 스키마에 대한 USAGE 권한과 스테이지에 대한 WRITE 권한이 부여되거나 이러한 권한을 상속하는 역할을 사용합니다.

  • 다른 업로드가 진행 중인지 확인하십시오. 비활성 버튼 위로 마우스를 가져가면 진행 중인 모든 업로드에 대한 정보가 표시됩니다. Snowsight 에는 진행 중인 업로드에 대한 알림도 표시됩니다. 다른 업로드가 진행 중인 경우 해당 업로드가 완료되어야 추가 파일을 스테이지에 업로드할 수 있습니다.