웹 인터페이스를 사용하여 데이터 로드하기

Snowsight 또는 Classic Console 를 사용하여 정형 데이터(예: CSV, TSV) 또는 반정형 데이터(예: JSON, Avro, ORC, Parquet 또는 XML)가 있는 파일을 로드할 수 있습니다.

웹 인터페이스를 사용하여 최대 크기 250MB의 파일에서 데이터를 로드합니다. 용량이 더 큰 파일이나 더 많은 수의 파일을 로드하려면 Snowflake 클라이언트인 SnowSQL을 사용하십시오. 자세한 내용은 로컬 파일 시스템에서 대량 로드하기 섹션을 참조하십시오.

이 항목의 내용:

Snowsight 를 사용한 데이터 로드

다음 시나리오에는 Snowsight 를 사용하여 파일을 로드할 수 있습니다.

  • 로컬 컴퓨터 또는 스테이지에서 기존 테이블로 파일 1개 또는 여러 파일을 로드합니다.

  • 로컬 파일 또는 스테이징된 파일을 로드할 때 새 테이블을 만드는 경우. Snowsight 는 INFER_SCHEMA 테이블 함수를 사용하여 파일 메타데이터 스키마를 자동으로 감지하고, 열 정의를 불러오고, 새 테이블을 생성합니다. 이 기능은 XML 파일을 지원하지 않습니다.

최대 250MB 크기의 개별 파일에서 데이터를 로드할 수 있습니다.

액세스 제어 권한

Snowsight 는 데이터베이스, 스키마 또는 테이블에 대한 권한을 부여하기 위해 데이터베이스 역할을 사용하는 것을 지원하지 않습니다. 계정 역할을 사용하여 Snowsight 와 상호 작용합니다. 자세한 내용은 역할 유형 섹션을 참조하십시오.

Snowsight 를 사용한 데이터 로드

Snowsight 를 사용하여 데이터를 로드하려면 최소 다음 권한이 있는 역할이 필요합니다.

오브젝트

권한

참고

데이터베이스

USAGE

스키마

USAGE

스테이지

USAGE

스테이지에서 파일을 로드하는 데 필요합니다.

파일 형식

USAGE

명명된 파일 형식 을 사용하는 경우 필수입니다.

테이블

OWNERSHIP

Snowsight 를 사용하여 데이터를 로드할 때 새 테이블 만들기

Snowsight 를 사용하여 데이터를 로드할 때 새 테이블을 만들려면 최소 다음 권한이 있는 역할이 필요합니다.

오브젝트

권한

참고

데이터베이스

USAGE

스키마

CREATE TABLE

스테이지

USAGE

테이블

OWNERSHIP

기존 테이블에 파일 로드하기

  1. Snowsight 에 로그인합니다.

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

  3. Add Data 페이지에서 Load data into a Table 을 선택합니다.

    Load Data into Table 대화 상자가 나타납니다.

  4. Load Data into Table 대화 상자에서 테이블을 만들 데이터베이스와 스키마를 선택하거나 생성합니다.

  5. Browse 를 선택하여 로컬 컴퓨터, Drag and drop to upload files 또는 Add from stage 에서 파일을 추가합니다.

    Add from stage 를 선택하면 스테이지 탐색기가 표시됩니다. 스테이지 탐색기에서는 스테이지와 하위 폴더로 이동할 수 있으며, 스테이지에서 특정 폴더와 파일을 선택할 수 있습니다. 스테이지에서 특정 파일을 선택하지 않고 Add 를 선택하면 스테이지의 모든 파일과 폴더가 포함된 루트 스테이지가 추가됩니다.

    스테이지 폴더에 표시할 수 있는 최대 파일 수는 250개입니다.

  6. 파일을 추가한 후 Next 을 선택합니다. 테이블 스키마 대화 상자가 표시됩니다.

  7. 테이블 스키마 대화 상자에서 다음을 수행합니다.

    • 현재 데이터베이스에서 파일 형식 을 선택합니다.

    • 사용자 지정할 파일 타입을 선택한 다음 데이터 파일에 대한 관련 설정을 선택합니다.

    • (선택 사항) 로드하는 동안 오류가 발생하면 어떻게 해야 하는지 선택합니다. 기본적으로, 파일에서는 아무런 데이터도 로드되지 않습니다.

    • Match by column names 옵션 중 하나를 선택하여 소스 파일과 대상 테이블을 자동으로 일치시킵니다. 기본 옵션은 case insensitive 입니다.

      스키마 감지 및 시각적 열 매핑은 XML을 지원하지 않습니다.

    • 테이블 스키마 대화 상자의 오른쪽에 있는 Edit Schema 탭을 선택합니다. 소스 파일과 대상 테이블 사이에 불일치 사항이 있는지 확인할 수 있습니다. 필요에 따라 조정하십시오.

    • Table Preview 탭을 선택하면 수신되는 소스 파일의 데이터가 대상 테이블에서 어떻게 표시되는지 미리 볼 수 있습니다.

  8. Load 를 선택합니다.

    Snowsight가 파일을 로드하고 테이블에 성공적으로 삽입된 행 수를 표시합니다.

파일을 로드할 때 테이블 만들기

다음 단계를 수행하면 파일을 로드할 때 새 테이블을 만들 수 있습니다.

참고

이 기능은 구분 기호로 분리된 파일, JSON, Parquet, Avro 및 ORC 파일을 지원합니다. XML 파일은 지원하지 않습니다.

  1. Snowsight 에 로그인합니다.

  2. 탐색 메뉴에서 Create » Table » From File 를 선택합니다.

    Load Data into Table 대화 상자가 나타납니다.

  3. Load Data into Table 대화 상자에서 테이블을 만들 데이터베이스와 스키마를 선택하거나 생성합니다.

  4. Browse 를 선택하여 로컬 컴퓨터, Drag and drop to upload files 또는 Add from stage 에서 파일을 추가합니다.

    Add from stage 를 선택하면 스테이지 탐색기가 표시됩니다. 스테이지 탐색기에서는 스테이지와 하위 폴더로 이동할 수 있으며, 스테이지에서 특정 폴더와 파일을 선택할 수 있습니다. 스테이지에서 특정 파일을 선택하지 않고 Add 를 선택하면 스테이지의 모든 파일과 폴더가 포함된 루트 스테이지가 추가됩니다.

    스테이지 폴더에 표시할 수 있는 최대 파일 수는 250개입니다.

  5. 새 테이블의 이름을 입력한 다음 Next 를 선택합니다.

    Snowsight 는 파일의 메타데이터 스키마를 감지하고 INFER_SCHEMA 함수로 식별된 파일 형식과 열 정의를 반환합니다.

  6. 유추된 파일 형식, 데이터 타입, 열 이름, 열 데이터 샘플을 검토합니다. 모든 정보가 정확한지 확인하고 필요한 경우 업데이트합니다.

  7. Load 를 선택합니다.

    Snowsight는 파일을 로드하고 해당 파일에 대한 새 테이블을 생성합니다.

Classic Console을 사용하여 데이터 로드하기

Classic Console 는 소규모 파일 세트에서 테이블로 제한된 양의 데이터를 로드하기 위한 마법사를 제공합니다. 마법사는 SQL을 사용하는 것과 동일한 PUT 및 COPY 작업을 수행하지만 두 단계(파일 스테이징과 데이터 로드)를 단일 작업으로 결합하고 로드 완료 후에는 스테이징된 파일을 전부 삭제합니다.

로컬 컴퓨터의 파일에서 데이터를 로드하거나 Snowflake, Amazon S3, Google Cloud Storage 또는 Microsoft Azure의 기존 클라우드 저장소 위치에 이미 스테이징된 파일에서 데이터를 로드할 수 있습니다.

데이터 로딩의 전제 조건

Classic Console 를 사용하여 데이터를 로드하려면 먼저 다음을 수행하십시오.

  • 데이터 파일의 위치를 식별합니다. 다음 중 하나에서 데이터를 로드할 수 있습니다.

    • 로컬 컴퓨터.

    • 내부 또는 외부 스테이지.

    • 아직 Snowflake에 외부 스테이지로 추가되지 않은 Amazon S3, Google Cloud Storage 또는 Microsoft Azure의 클라우드 저장소 위치.

  • 데이터 파일의 크기를 결정합니다. 로드하는 각 파일의 크기는 최대 250MB까지 가능합니다. 용량이 더 큰 파일이나 더 많은 수의 파일을 로드하려면 Snowflake 클라이언트인 SnowSQL을 대신 사용하십시오. 로컬 파일 시스템에서 대량 로드하기 섹션을 참조하십시오.

데이터를 로드하는 데 사용하는 역할에는 다음과 같은 적절한 권한이 있어야 합니다.

  • 데이터를 로드하려면 역할에 데이터를 로드하는 테이블을 포함한 데이터베이스와 스키마에 대한 USAGE 권한이 있어야 합니다.

  • 데이터를 로드할 때 스테이지를 생성하려면 역할에 데이터베이스 스키마에 대한 CREATE STAGE 권한이 있어야 합니다.

  • 데이터를 로드할 때 파일 형식을 생성하려면 역할에 데이터베이스 스키마에 대한 CREATE FILE FORMAT 권한이 있어야 합니다.

데이터 로딩 시작하기

파일을 특정 테이블에 로드하려면 먼저 다음을 수행하십시오.

  1. Databases 데이터베이스 탭 를 선택합니다.

  2. 특정 데이터베이스와 스키마를 선택합니다.

  3. Tables 탭을 선택합니다.

  4. 데이터를 로드할 테이블을 찾습니다.

  5. 다음 중 하나를 수행하여 특정 테이블에 데이터를 로드하기 시작합니다.

    • 테이블 행을 선택한 다음 Load Data 를 선택합니다.

    • 테이블 이름을 선택하여 테이블 세부 정보 페이지를 연 다음 Load Table 을 선택합니다.

    Load Data 마법사가 열립니다.

  6. 테이블에 데이터를 로드하는 데 사용할 웨어하우스를 선택합니다. 드롭다운에는 USAGE 권한이 있는 모든 웨어하우스가 포함됩니다.

  7. Next 를 선택합니다.

로드할 데이터 선택하기

데이터를 로드하기로 선택한 위치에 따라 관련 단계를 따르십시오. 여러 위치에서 데이터를 로드하려면 Load Data 마법사를 여러 번 사용하십시오.

컴퓨터에서 데이터를 로드하려면 다음을 수행하십시오.

  1. Load files from your computer 옵션을 선택하고 Select Files 를 선택하여 로드하려는 파일을 찾아봅니다.

  2. 1개 이상의 로컬 데이터 파일을 선택하고 Open 을 선택합니다.

  3. Next 를 선택합니다.

기존 스테이지에서 데이터를 로드하려면 다음을 수행하십시오.

  1. Load files from external stage 옵션을 선택합니다.

  2. Stage 드롭다운 목록에서 기존 스테이지를 선택합니다.

  3. (선택 사항) 스테이지에서 파일의 경로를 지정합니다.

  4. Next 를 선택합니다.

예를 들어 외부 클라우드 저장소에서 데이터를 로드하기 위해 스테이지를 생성하려면 다음을 수행하십시오.

  1. Load files from external stage 옵션을 선택합니다.

  2. Stage 드롭다운 목록 옆의 + 를 선택합니다.

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

  4. Next 를 선택합니다.

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

  6. Finish 를 선택합니다.

    Stage 드롭다운 목록에서 새 스테이지가 자동으로 선택됩니다.

  7. (선택 사항) 스테이지에서 파일의 경로를 지정합니다.

  8. Next 를 선택합니다.

데이터 로딩 마치기

로드할 파일을 선택한 후 데이터를 테이블에 로드하는 작업을 마칩니다.

참고

데이터 로드를 마쳤을 때 웨어하우스가 실행 중이지 않을 경우 데이터가 로드되기 전에 웨어하우스가 실행을 재개할 때까지 기다려야 합니다(최장 5분).

데이터 로딩을 마치려면 다음을 수행하십시오.

  1. 드롭다운 목록에서 명명된 기존 파일 형식을 선택하거나 새 파일 형식을 만듭니다.

    파일 형식을 만들려면 다음을 수행하십시오.

    1. 드롭다운 목록 옆의 + 를 선택합니다.

    2. 데이터 파일의 형식과 일치하도록 필드를 채웁니다. 옵션에 대한 설명은 CREATE FILE FORMAT 섹션을 참조하십시오.

    3. Finish 를 선택합니다.

    명명된 새 파일 형식이 드롭다운 목록에서 자동으로 선택됩니다.

  2. 데이터를 로드할 때 발생하는 오류를 처리할 방법을 결정합니다.

    • 오류가 발생할 경우 데이터 로드를 중지하려면 Load 를 선택하십시오.

    • 오류를 다른 방식으로 처리하려면 다음을 수행하십시오.

      1. Next 를 선택합니다.

      2. 오류를 처리할 방법을 설명하는 옵션을 선택합니다. 옵션에 대한 자세한 내용은 COPY INTO <테이블> 의 ON_ERROR 섹션을 참조하십시오.

      3. Load 를 선택합니다.

    Snowflake는 선택한 웨어하우스를 사용하여 선택한 테이블에 데이터를 로드합니다.

  3. OK 를 선택하여 Load Data 마법사를 닫습니다.

언어: 한국어