Cloud에 파일 업로드

Cloud에 파일을 업로드하는 방법을 알아봅니다

ClickHouse Cloud는 파일을 손쉽게 가져올 수 있는 방법을 제공하며, 다음 포맷을 지원합니다:

포맷
CSV
CSVWithNamesAndTypes
CSVWithNames
JSONEachRow
TabSeparated
TabSeparatedWithNames
TabSeparatedWithNamesAndTypes

1. ​

   파일 업로드

   아래와 같이 Cloud 홈 페이지에서 서비스를 선택합니다:

   서비스가 유휴 상태이면 먼저 활성화해야 합니다.

   아래와 같이 왼쪽 탭에서 Data sources를 선택합니다:

   다음으로 데이터 소스 페이지 오른쪽에서 Upload a file을 선택합니다:

   파일 선택 대화상자가 나타나며, Cloud 서비스의 테이블에 데이터를 삽입하는 데 사용할 파일을 선택할 수 있습니다.

2. ​

   테이블 구성

   파일 업로드가 완료되면 데이터를 삽입할 테이블을 구성할 수 있습니다. 처음 3개 행이 표시된 테이블 미리보기도 함께 제공됩니다.

   이제 대상 테이블을 선택할 수 있습니다. 옵션은 다음과 같습니다:

   • 새 테이블
   • 기존 테이블

   
   

   데이터를 업로드할 데이터베이스를 지정할 수 있으며, 새 테이블인 경우 생성할 테이블 이름도 지정할 수 있습니다. 또한 정렬 키를 선택할 수 있습니다:

   파일에서 읽은 컬럼은 Source field로 표시되며, 각 필드에 대해 다음을 변경할 수 있습니다:

   • 추론된 타입
   • 기본값
   • 해당 컬럼을 널 허용로 설정할지 여부

   필드 제외

   가져오기에 포함하지 않으려는 필드는 제거할 수도 있습니다.

   사용할 테이블 엔진을 지정할 수 있습니다:

   • MergeTree
   • ReplacingMergeTree
   • SummingMergeTree
   • Null

   
   

   파티셔닝 키 표현식과 프라이머리 키 표현식을 지정할 수 있습니다.

   데이터를 가져오려면 Import to ClickHouse(위 그림 참조)를 클릭합니다. 데이터 가져오기는 아래와 같이 Status 컬럼의 queued 상태 배지로 표시되며 큐에 들어갑니다. 또한 Open as query(위 그림 참조)를 클릭하여 SQL 콘솔에서 삽입 쿼리를 열 수도 있습니다. 이 쿼리는 URL 테이블 함수를 사용하여 S3 버킷에 업로드된 파일의 데이터를 삽입합니다.

   작업이 실패하면 Data upload history 탭의 Status 컬럼 아래에 failed 상태 배지가 표시됩니다. View Details를 클릭하면 업로드 실패 원인에 대한 자세한 정보를 확인할 수 있습니다. 실패한 삽입의 오류 메시지에 따라 테이블 구성을 수정하거나 데이터를 정리해야 할 수 있습니다.