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