CSV 파일(쉼표로 값을 구분하는 파일)을 업로드하여 거의 모든 소스의 데이터를 데이터 스튜디오로 가져올 수 있습니다. 파일 업로드를 이용하면 특정 커넥터가 지원하지 않는 데이터에 대한 보고서를 볼 수 있습니다.
파일 업로드 작동 방식
파일을 업로드하면 해당 파일이 '데이터 세트'에 추가됩니다. 그러면 이 데이터 세트를 토대로 데이터 소스를 만들 수 있습니다.
데이터 세트는 만든 사람이 소유자이며 공유할 수 없습니다. 그러나 데이터 세트를 토대로 만든 데이터 소스는 다른 데이터 소스처럼 공유 및 수정이 가능합니다. 즉, 데이터 세트를 공유 데이터 소스 및 보고서에서 사용할 수 있지만 데이터 세트 자체에는 나만 액세스할 수 있습니다.
데이터 세트에 여러 파일을 업로드할 수 있습니다. 새 파일을 추가하면 해당 데이터가 데이터 세트에 추가됩니다.
업로드된 데이터는 Cloud Storage에 저장됩니다. 클라우드에서 데이터에 액세스하고 데이터를 다운로드할 수 있으며 데이터에 다른 Google Cloud 서비스를 사용할 수 있는 등 여러 이점이 있습니다.
Cloud Storage에 대해 자세히 알아보기
CSV 파일 데이터 소스 만들기
데이터 스튜디오는 업로드된 CSV 파일을 데이터 세트에 저장합니다. 데이터 세트에는 열 헤더가 동일한 CSV 파일이 하나 이상 포함될 수 있습니다. CSV 파일 데이터 소스에는 하나 이상의 데이터 세트가 포함될 수 있습니다.
새 CSV 파일 데이터 소스를 만들려면 다음 단계를 따르세요.
- 데이터 스튜디오에 로그인합니다
- 만들기 버튼을 클릭한 다음 데이터 소스를 선택합니다.
- CSV 파일 업로드 Google 커넥터를 선택합니다.
- 데이터 세트 추가 버튼을 클릭하여 새 데이터 세트를 만듭니다.
- 하나 이상의 CSV 파일을 사용 가능한 데이터 세트 섹션으로 드래그할 수도 있습니다. 그러면 데이터 스튜디오에서 업로드된 파일이 포함된 새 데이터 세트를 만듭니다.
- 파일 업로드를 완료하면 연결 버튼을 클릭합니다.
업로드된 데이터는 Cloud Storage에 저장됩니다. 이러한 스토리지 설정에는 클라우드에서 데이터에 액세스하고 다운로드하는 기능과 데이터에 다른 Google Cloud 서비스를 사용하는 기능을 비롯한 여러 이점이 있습니다.
Cloud Storage에 대해 자세히 알아보기
데이터 세트에 CSV 파일 추가
열 헤더가 일치하는 한 데이터 세트에 여러 파일을 업로드할 수 있습니다. 새 파일을 추가하면 해당 데이터가 데이터 세트에 추가됩니다. 이렇게 하면 시간이 지남에 따라 데이터를 업데이트할 수 있습니다.
데이터 세트에 CSV 파일을 추가하려면 다음 단계를 따르세요.
- 데이터 스튜디오에 로그인합니다
- 데이터 소스 탭을 클릭합니다.
- CSV 파일이 포함된 데이터 소스를 선택합니다.
- 연결 수정을 클릭합니다.
- 사용 가능한 데이터 세트 섹션에서 파일을 추가할 데이터 세트를 선택합니다.
- 파일 추가 버튼을 클릭합니다.
- 하나 이상의 CSV 파일을 데이터 세트의 파일 섹션으로 드래그할 수도 있습니다.
- 파일 업로드가 완료되면 다시 연결 버튼을 클릭합니다.
데이터 세트 공유
데이터 세트는 만든 사람이 소유자이며 공유할 수 없습니다. 하지만 데이터 세트를 기반으로 데이터 소스를 만들면 다른 사용자와 해당 데이터 소스를 공유할 수 있습니다. 즉, 데이터 세트를 공유 데이터 소스 및 보고서에서 사용할 수 있지만 데이터 세트 자체에는 나만 액세스할 수 있습니다.
업로드 파일 형식
업로드할 파일의 형식이 맞는지 확인해야 합니다. 그렇지 않으면 업로드 중에 오류가 발생하거나 데이터가 보고서에 제대로 나타나지 않을 수 있습니다.
콘텐츠 오류가 발생하는 가장 일반적인 원인은 업로드된 데이터에서 구분 기호, 따옴표, 줄바꿈 문자가 부적절하게 사용된 경우일 가능성이 큽니다. 파일 업로드가 이 문제를 처리하는 과정을 이해하면 수고를 덜 수 있습니다.
UTF-8 인코딩
업로드 파일은 UTF-8 인코딩이어야 합니다. 대부분의 웹 애플리케이션에 대한 표준 인코딩 방식입니다.
하지만 Microsoft Excel과 같은 특정 데스크톱 제품에서 데이터를 내보내는 경우 데이터 스튜디오를 사용하여 업로드하기 전에 파일을 UTF-8로 변환해야 할 수 있습니다. 그렇지 않으면 데이터 스튜디오에서 Invalid characters in the file. Only UTF-8 encoded characters are supported.과 같은 오류 메시지를 반환할 수 있습니다.
테이블 형식 데이터만 지원
파일 업로드는 테이블 형식 데이터 파일만 가져올 수 있습니다. 따라서 파일은 행과 열이 일반적 구조로 되어 있어야 합니다. 각 행에는 동일한 수의 열이 있어야 하며, 이는 표의 특정 셀에 데이터가 없는 경우에도 마찬가지입니다. 병합된 셀이 있거나 일관성 없는 구조로 된 파일을 업로드하려고 하면 업로드 오류가 발생하면서 업로드에 실패합니다.
구분 기호
데이터의 모든 필드는 쉼표로 구분되어야 합니다.
업로드하려는 필드의 실제 데이터 내에 쉼표가 있으면 해당 필드를 따옴표로 묶어야 합니다. 데이터에 큰따옴표가 포함되어 있으면 작은따옴표 문자로 필드를 묶습니다.
헤더 행
파일의 첫 번째 줄은 헤더 행이어야 합니다. 데이터 스튜디오는 이 행을 토대로 필드 이름을 지정합니다. 필드 이름은 고유해야 하므로 헤더 행에 중복된 값이 포함되어서는 안 됩니다.
열 이름은 다음 조건을 충족해야 합니다.
- 문자, 숫자, 밑줄만 포함해야 합니다. 다른 문장 부호나 특수문자는 사용할 수 없습니다.
- 문자 또는 밑줄로 시작해야 합니다.
- 128자(영문 기준) 이하여야 합니다.
헤더 행 또한 구분자 규칙을 따라야 합니다.
줄바꿈
파일의 각 줄은 줄바꿈으로 끝나야 합니다. 줄바꿈이 따옴표로 이스케이프된 경우에도 파일 업로드는 데이터 줄바꿈을 지원하지 않습니다.
문제 해결
다음 섹션에서는 CSV 파일을 업로드하는 동안 발생할 수 있는 일반적인 오류를 설명합니다.
오류: 파일이 잘못되었습니다.
CSV 파일을 업로드하려고 시도한 후 데이터 스튜디오에 File is Invalid 오류가 표시되면 다음과 같은 원인이 있을 수 있습니다.
- 파일에 잘못된 UTF-8 문자가 포함되어 있습니다.
- 파일이 실제로는 CSV 파일이 아닙니다. 예를 들어 PDF 파일의 이름을 '.csv' 확장자를 사용하도록 변경하면 데이터 스튜디오에서 파일을 제대로 파싱할 수 없습니다.
파일 업로드 한도
파일 업로드에는 다음과 같은 제한이 적용됩니다.
- 사용자당 데이터 세트 1,000개
- 사용자당 총 2GB의 스토리지
- 데이터 세트당 일일 업로드 100회
- 데이터 세트당 파일 크기 100MB 이하