CSV 파일 (쉼표로 값을 구분하는 파일)을 제공하는 모든 소스의 데이터를 Looker 보고서로 가져올 수 있습니다. 컴퓨터에서 직접 CSV 파일을 업로드할 수 있습니다.
CSV 파일 데이터 소스 만들기
Looker 보고서는 업로드된 CSV 파일을 데이터 세트에 저장합니다. 데이터 세트에는 동일한 열 헤더가 있는 하나 이상의 CSV 파일이 포함될 수 있습니다. CSV 파일 데이터 소스에는 하나 이상의 데이터 세트가 포함될 수 있습니다.
새 CSV 파일 데이터 소스를 만들려면 다음 단계를 따르세요.
- Looker 보고서를 엽니다.
- 만들기 버튼을 클릭한 후 데이터 소스 를 선택합니다.
- CSV 파일 업로드 Google 커넥터를 선택합니다.
- 데이터 세트 추가 버튼을 클릭하여 새 데이터 세트를 만듭니다.
- 하나 이상의 CSV 파일을 사용 가능한 데이터 세트 섹션으로 드래그할 수도 있습니다. 그러면 Looker 보고서에서 업로드된 파일이 포함된 새 데이터 세트를 만듭니다.
- 파일 업로드를 완료하면 연결 버튼을 클릭합니다.
업로드된 데이터는 Cloud Storage에 저장됩니다. 이 저장소 설정에는 클라우드에서 데이터에 액세스하고 다운로드할 수 있는 기능과 데이터를 다른 서비스 Google Cloud 와 함께 사용할 수 있는 기능 등 여러 가지 이점이 있습니다.
데이터 세트에 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 이하