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

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

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

이 항목의 내용:

Snowsight를 사용하여 데이터 로드하기

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

  • 로컬 컴퓨터에서 한 파일이나 여러 파일을 기존 테이블에 로드하는 경우.

  • 스테이지에서 기존 테이블로 파일을 로드하는 경우.

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

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

참고

Snowsight 를 사용하여 데이터를 로드하려면 데이터를 로드하려는 테이블에 대한 OWNERSHIP 권한과 테이블을 포함하는 데이터베이스와 스키마에 대한 USAGE 권한이 있는 역할을 사용해야 합니다. 테이블 권한 섹션을 참조하십시오.

명명된 파일 형식 을 사용하려면 역할에 해당 특정 파일 형식에 대한 USAGE 권한도 있어야 합니다.

로컬 컴퓨터에서 기존 테이블에 파일 로드하기

  1. Snowsight 에 로그인합니다.

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

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

  4. 오브젝트 탐색기에서 데이터를 로드할 테이블을 선택합니다.

  5. Load Data 를 선택합니다.

  6. Load Data into Table 대화 상자에서 Browse 을 선택합니다.

  7. 정형 또는 반정형 데이터 파일을 추가합니다.

  8. 사용자에 대해 설정된 기본 웨어하우스가 없는 경우 웨어하우스를 선택하십시오.

  9. Next 를 선택합니다.

  10. 다음 중 하나를 수행하십시오.

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

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

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

  12. Load 를 선택합니다.

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

  13. 다음 중 하나를 수행하십시오.

    • 테이블을 쿼리하기 위한 SQL 구문으로 워크시트를 열려면 Query Data 를 선택하십시오.

    • 대화 상자를 닫으려면 Done 을 선택하십시오.

    예를 들어 파일의 열이 테이블에 지정된 열과 일치하지 않아 파일을 로드할 수 없는 경우 오류 메시지가 표시됩니다. 설정을 조정하려면 Back 을 선택하십시오.

스테이지에서 기존 테이블에 파일 로드하기

스테이지에서 테이블로 파일을 로드하기 전에 스테이지를 생성하고 파일을 스테이지에 업로드해야 합니다. 자세한 지침은 Snowsight를 사용하여 파일 스테이징하기 섹션을 참조하십시오.

  1. Snowsight 에 로그인합니다.

  2. 오브젝트 탐색기에서 파일을 로드할 스테이지를 선택합니다.

  3. 스테이지의 파일 목록에서 테이블에 로드할 파일을 선택합니다.

  4. 선택한 파일의 줄임표 드롭다운 메뉴에서 Load into table 을 선택합니다.

  5. Load Data into Table 대화 상자에서 파일을 로드하려는 데이터베이스, 스키마, 테이블을 선택합니다.

  6. Next 를 선택합니다.

  7. 다음 중 하나를 수행하십시오.

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

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

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

  9. Load 를 선택합니다.

    Snowsight 에서 파일을 스테이지에서 테이블로 로드합니다.

또는 스테이징된 파일의 경로를 복사하여 스테이징된 파일을 테이블로 로드할 수 있습니다.

  1. 이전 절차에서 1~3단계를 따릅니다.

  2. 스테이지에서 선택한 파일의 줄임표 드롭다운 메뉴에서 Copy path 를 선택합니다.

  3. 오브젝트 탐색기에서 데이터를 로드할 테이블을 선택합니다.

  4. Load Data 를 선택합니다.

  5. 이때 나타나는 Load Data into Table 대화 상자에서 Add from Stage 를 선택합니다.

  6. 복사한 경로를 경로 필드에 붙여넣은 다음 Add 를 선택합니다.

    스테이징된 파일 이름이 나타납니다.

  7. Next 를 선택합니다.

  8. 다음 중 하나를 수행하십시오.

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

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

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

  10. Load 를 선택합니다.

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

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

다음 단계를 수행하면 파일을 로드할 때 새 테이블을 만들 수 있습니다. 또는 이전 섹션 스테이지에서 기존 테이블에 파일 로드하기 의 1~4단계에 따라 스테이지에서 Load Data into Table 대화 상자를 연 후 6~10단계에 따라 동일한 작업을 완료할 수 있습니다.

참고

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

아래 작업을 수행하려면 테이블 생성 권한 이 있어야 합니다.

  1. Snowsight 에 로그인합니다.

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

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

  4. Create 를 선택합니다.

  5. 드롭다운 메뉴에서 Table » From File 을 선택합니다.

  6. Load Data into Table 대화 상자에서 Browse to add a file, Drag and drop a file to the dialog 또는 Add a file from stage 를 선택합니다. 선택 사항으로, 파일 위치를 선택합니다.

  7. 테이블을 생성하려는 데이터베이스와 스키마를 선택합니다.

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

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

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

  10. 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 마법사를 닫습니다.