DSPL FAQ

이 문서에서는 데이터 소유자가 DSPL 데이터 세트를 만들고 이를 공개 데이터 탐색기에 업로드할 때 가장 자주 발생하는 문제를 다룹니다.

목차

일반적인 질문

DSPL이란 무엇인가요?

DSPL은 데이터 세트 게시 언어(Dataset Publishing Language)의 약자입니다. 이는 메타데이터(데이터 세트의 이름 및 제공업체와 같은 데이터 세트에 관한 정보, 데이터 세트에 포함되고 표시되는 개념)와 데이터 세트의 실제 데이터를 모두 나타내는 표현 형식입니다. 메타데이터는 XML로 지정되고 데이터는 CSV 형식으로 제공됩니다.

DSPL 사용의 주요 이점은 무엇인가요?

DSPL은 공개 데이터 탐색기와 같은 풍부한 데이터 시각화를 위해 처음부터 설계되었습니다. 이를 만들려면 다른 데이터 세트 형식에서 잘 지원되지 않는 항목인 슬라이스, 측정기준, 측정항목에 관한 세부 메타데이터가 필요합니다.

DSPL은 데이터 세트 가져오기, 개념 계층 구조(예: '국가'는 '대륙'의 하위 요소), 지오코딩된 데이터, 데이터 탐색 환경을 개선하는 다양한 고유 기능도 지원합니다.

DSPL은 데이터 교환 또는 분석에 사용되는 다른 형식을 대체하나요?

일반적으로는 그렇지 않습니다. 이전 답변에서 언급했듯이 DSPL은 대화형 시각화 및 탐색을 위해 설계되었습니다. 일반적인 다목적 데이터 교환 또는 분석 형식으로 사용하기 위한 것이 아닙니다.

궁극적으로 DSPL은 다른 형식을 보완하는 것으로 간주됩니다. 사용자는 풍부한 대화형 데이터 시각화를 만들기 위해 다른 소스에서 DSPL 데이터 세트를 만들 수 있어야 합니다.

DSPL 데이터 세트로 무엇을 할 수 있나요?

공개 데이터 탐색기로 가져와 게시하고 다른 사용자가 풍부한 대화형 시각화를 통해 데이터를 탐색하도록 허용할 수 있습니다. 게시된 데이터 세트는 관심 있는 사용자가 찾을 수 있도록 공개 데이터 디렉터리에 포함될 수도 있습니다.

현재 DSPL을 사용하는 유일한 애플리케이션입니다. 하지만 다른 애플리케이션에도 이 형식을 사용하는 것이 좋으며 시간이 지남에 따라 채택이 증가할 것으로 예상됩니다.

DSPL에 가장 적합한 데이터 세트 유형은 무엇인가요?

DSPL 형식은 임의의 테이블 컬렉션을 지원하므로 다양한 데이터 세트 유형에 적합합니다. 그러나 DSPL 데이터 세트의 하위 집합만 공개 데이터 탐색기에서 흥미로운 시각화를 생성합니다. 특히 후자의 제품은 다음과 같은 데이터에 가장 적합합니다.

  • 정량적: 각 데이터 포인트에는 하나 이상의 숫자 측정항목이 연결되어 있습니다(예: '인구', '독감 사례 수', '수익').
  • 범주형: 데이터를 텍스트로 설명 가능한 유한한 수의 카테고리(예: '국가', '성별', '연령대')로 구성할 수 있습니다.
  • 시계열: 각 카테고리의 데이터 측정항목은 시간의 함수에 따라 달라지며 인접한 지점은 최소 하루 간격입니다(공개 데이터 탐색기는 하루보다 작은 시간 증가를 시각화할 수 없음).
  • 집계: 각 시간/카테고리/측정항목 조합에는 이벤트 또는 사실 목록이 아닌 단일 데이터 포인트가 있습니다.

DSPL 데이터 세트를 만들었으며 다른 사용자가 찾을 수 있도록 Google 공개 데이터 디렉터리에 표시하고 싶습니다. 누구에게 문의해야 하나요?

이 양식을 작성하고 데이터 세트 링크를 제공하세요.

DSPL에 문제가 있습니다. 도움이 필요하면 어디에 요청하나요?

DSPL 토론 포럼에 문제를 게시하세요.

DSPL 데이터 세트 파일

XML 및 CSV 파일을 어떻게 인코딩해야 하나요?

모든 XML 및 CSV 파일은 UTF-8로 인코딩되어야 합니다. ASCII('일반 텍스트'라고도 함)는 UTF-8의 하위 집합이므로 이 형식의 데이터 세트도 작동합니다.

데이터 세트 파일을 만들고 수정하려면 어떤 소프트웨어를 사용해야 하나요?

XML 파일을 수정할 때는 가독성을 위해 구문 강조 표시가 있는 일반 텍스트 편집기를 사용하는 것이 좋습니다. 플랫폼별 권장사항은 이 도움말을 참고하세요. 모든 기능을 갖춘 범용 워드 프로세서는 XML에 추가 서식 태그를 삽입하여 가져오기 오류를 일으킬 수 있으므로 사용하지 않는 것이 좋습니다.

스프레드시트는 일반적으로 데이터 파일을 만들고 수정하는 가장 쉬운 방법입니다. 올바른 형식(CSV/쉼표로 구분된 값)으로 저장해야 합니다.

Excel, SPSS, SAS 또는 다른 시스템에 데이터가 있습니다. 이러한 데이터를 공개 데이터 탐색기로 직접 가져올 수 있나요?

아니요. 현재는 그렇지 않지만 먼저 데이터를 CSV 형식으로 내보내고, 적절한 XML 메타데이터를 추가한 다음, DSPL 호환 데이터 세트를 공개 데이터 탐색기에 업로드해야 합니다.

파일 이름이 중요한가요?

데이터 세트 XML 파일의 이름은 .xml로 끝나야 합니다. 연결된 CSV 데이터 파일은 XML 메타데이터의 <file> 태그에 지정된 이름과 일치하는 한 어떤 이름이든 가질 수 있습니다. 데이터 세트를 패키징하고 공개 데이터 탐색기로 가져오는 데 사용되는 ZIP 파일에도 원하는 이름을 지정할 수 있습니다.

CSV 파일을 정렬해야 하나요?

예. CSV 파일의 콘텐츠를 시간 이외의 측정기준(순서 또는 방향에 관계없이)으로 정렬한 다음, 원하는 경우 다른 열(예: 시간)로 정렬해야 합니다.

예를 들어 date, dimension1, dimension2, metric1, metric2 열이 있는 CSV가 있는 경우 dimension1 및 dimension2(순서에 관계없이)를 기준으로 정렬해야 합니다. 날짜/시간 열을 기준으로 정렬하려면 마지막으로 정렬해야 합니다.

이러한 방식으로 정렬하면 각 시계열의 관측치가 함께 그룹화되어 DSPL 가져오기 프로세스의 효율성이 크게 향상됩니다.

XML 모델 및 문법

측정항목과 측정기준을 어떻게 구분해야 하나요?

측정기준은 데이터를 분류하거나 필터링하는 데 사용되는 항목입니다. 반면 측정항목은 각 데이터 포인트와 연결된 관측값을 설명합니다.

일반적으로 측정기준은 범주형인 반면 측정항목은 범주형이 아니며 시간에 따라 변하는 숫자 값입니다. 각각의 전형적인 예는 다음과 같습니다.

  • 측정기준: 국가, 주, 카운티, 지역, 연도, 월, 성별, 연령 카테고리, 업종 세그먼트
  • 측정항목: 인구, GDP, 실업률, 문해율, 수익, 비용, 가격

속성과 속성의 차이점은 무엇인가요?

속성은 개념의 각 인스턴스에 연결됩니다. 예를 들어 대륙 속성은 국가마다 값이 다릅니다. 반면 속성은 개념 전체와 연결됩니다. 예를 들어 isParent 속성은 모든 대륙에서 true입니다.

태그 순서가 중요한가요?

예. 개발자 가이드에 표시되는 순서대로 태그를 추가합니다. 예를 들어 개념 정의에서 <topic>는 <type> 앞에 표시되어야 합니다.

대소문자가 중요한가요?

예, XML 태그 및 속성 이름은 개발자 가이드에 표시된 것과 동일한 방식으로 대문자로 표기해야 합니다. 예를 들어 property 태그에서 isParent 대신 isparent를 사용하면 가져오기 오류가 발생합니다.

하나의 개념에 두 개의 상위 개념이 있을 수 있나요?

아니요. 각 개념에는 isParent 참조가 하나만 있을 수 있습니다.

개념이 자기 자신을 참조할 수 있나요?

예. 자체 참조 개념 계층 구조의 예시는 미국 소매 판매 데이터 세트를 참조하세요.

데이터 형식 지정

날짜 형식은 어떻게 지정하나요?

날짜는 Joda DateTime 표준으로 설명할 수 있는 모든 형식으로 작성할 수 있습니다. Joda 형식 지정 코드는 해당 테이블 열 요소 내의 format 속성에 저장해야 합니다.

일부 인기 있는 날짜 형식의 Joda 형식 지정 코드는 다음과 같습니다.

날짜 예시 Joda 형식
2010 yyyy
2010년 5월 MMM yyyy
2010년 5월 21일 MM/dd/yyyy
2010/05/21 dd/MM/yyyy
2010-05-21 yyyy-MM-dd

특히 월 문자의 Joda 코드는 m(분을 나타냄)가 아닌 M입니다.

1일보다 작은 시간 단위를 사용할 수 있나요?

Joda DateTime 형식과 DSPL은 밀리초 단위까지 시간 값을 지원합니다. 그러나 공개 데이터 탐색기는 아직 하루보다 작은 시간 단위를 시각화할 수 없습니다.

표준 개념 사용

'표준 개념'이란 무엇이며 어떻게 유용할까요?

'표준 개념'이라는 용어는 다른 데이터 세트의 기본 '구성요소'로 사용되는 Google에서 만든 개념 집합을 의미합니다. 개념 자체는 6개의 DSPL 데이터 세트에 걸쳐 정의되며, 이 데이터 세트는 개념을 '시간', '지역' 등의 카테고리로 그룹화합니다. 이러한 개념에 액세스하려면 DSPL XML 파일의 시작 부분에서 적절한 상위 데이터 세트를 가져오면 됩니다.

표준 개념은 시간을 절약하는 데 도움이 되며(예: 전 세계 모든 국가의 위도 및 경도 값을 수동으로 입력할 필요가 없음) 데이터가 시각화되는 방식을 나타내므로 유용합니다. 예를 들어 공개 데이터 탐색기는 time:... 개념을 사용하여 선 차트 x축의 형식을 지정하고, entity:entity 개념의 name 속성을 사용하여 측정기준 선택 도구 UI의 문자열을 생성하고, geo:location의 latitude 및 longitude 속성을 사용하여 지도 시각화에 데이터를 표시합니다.

공개 데이터 탐색기에서 모든 표준 개념을 이해하나요?

제공된 표준 개념 대부분은 공개 데이터 탐색기에서 이해할 수 있지만, 아직 시각화할 수 없는 개념도 있습니다. 이러한 문제는 아래에 몇 가지 권장 해결 방법과 함께 나와 있습니다.

개념 해결 방법
quantity:index 대신 quantity:ratio 또는 quantity:magnitude를 사용하세요.
time:quarter DSPL 설명서에 설명된 대로 time:month를 사용합니다.
time:week DSPL 설명서에 설명된 대로 time:day를 사용합니다.

향후 이러한 개념에 대한 지원이 개선될 예정입니다.

데이터 세트에서 표준 개념을 사용하려면 어떻게 해야 하나요?

사용하려는 특정 개념에 관한 문서를 참고하고 가장 일반적인 개념에 관한 자세한 단계별 안내가 포함된 DSPL Cookbook도 확인하세요.

데이터 세트 가져오기 및 시각화

데이터 세트를 가져올 수 없는 이유는 무엇인가요?

공개 데이터 탐색기의 업로드 인터페이스는 DSPL 데이터 세트를 스캔하고 오류가 감지되면 가져오기를 차단합니다. 가져오기 도구는 XML 파일의 맞춤법, 대소문자, 태그 순서/배치뿐만 아니라 CSV 파일의 데이터 레이아웃 및 정렬에 매우 민감하므로, 이를 올바르게 설정하고 데이터 세트를 성공적으로 가져오려면 몇 번의 시도가 필요할 수 있습니다.

이러한 문제를 해결하는 첫 번째 단계는 UI에 표시된 오류 메시지를 확인하고 적절한 시정 조치를 취하는 것입니다. 이러한 메시지는 이해하기 쉽지 않은 경우가 많으므로(Google에서 적극적으로 개선하고 있음) 가장 일반적인 메시지를 설명하는 표를 작성했습니다.

오류 설명
duplicate key: … 개념의 정의 테이블에 반복되는 ID 값(즉, 개념과 이름이 같은 열의 값)이 있습니다. 이러한 값은 개념의 개별 인스턴스를 고유하게 식별하는 데 사용되므로 중복이 허용되지 않습니다.
속성 조합([…])이 데이터의 두 개 이상의 고유한 행 그룹에 표시되어 소스에서 데이터 행을 파싱하는 중에 예외가 발생했습니다. CSV가 올바르게 정렬되지 않았습니다. 자세한 방법은 위의 설명을 참고하세요.
잘못된 형식으로 인해 소스에서 데이터 행을 파싱하는 중에 예외가 발생했습니다. '…'의 형식이 '…'에서 잘못되었습니다. CSV에서 이 값(일반적으로 날짜)의 형식이 XML 파일에 지정된 형식과 일치하지 않습니다. 형식 또는 값을 일치하도록 변경합니다.
소스에서 데이터 행을 파싱하는 중 예외가 발생했습니다. 원인: 줄(…)의 요소 수가 줄 […]에 지정된 속성(…) 수와 일치하지 않습니다. CSV의 행에 값이 너무 많거나 너무 적습니다. 이 행의 형식을 수정합니다.
입력 문자열 '…'로 인해 소스에서 데이터 행을 파싱하는 중에 예외가 발생했습니다. CSV의 값(일반적으로 정수 또는 부동 소수점 수)에 숫자가 아닌 문자(예: 달러 기호, 백분율 기호 등)가 포함되어 있어 제대로 파싱할 수 없습니다. 이러한 추가 문자를 삭제합니다.
'…' 슬라이스의 '…' 속성에 대한 데이터 값 '…'이 참조된 개념 '…'의 키 값이 아니므로 소스에서 데이터 행을 파싱하는 중에 예외가 발생했습니다. 슬라이스 중 하나에 인식할 수 없는 측정기준 값(예: 해당 개념에 대해 가능한 모든 값 목록에 없는 값)을 포함하는 경우 측정기준 개념 정의 표로 돌아가서 필요한 경우 값을 추가합니다.
데이터의 헤더 '…'은(는) 테이블의 상수 속성입니다. CSV의 열 헤더가 XML 테이블 정의에 정의된 열 ID와 일치하지 않습니다. 둘 중 하나를 변경하여 일치시킵니다.
XML 파싱 오류 … '…' 요소로 시작하는 잘못된 콘텐츠가 발견되었습니다. '{…}', '{…}', … 중 하나가 필요합니다. 참조된 XML 요소가 올바른 위치에 있지 않습니다. 순서가 올바른지, 요소에 올바른 상위 요소가 있는지 확인합니다(예: name의 경우 info).
XML 파싱 오류 … '…' 속성은 '…' 요소에 표시될 수 없습니다. 이 XML 태그 속성의 맞춤법, 대소문자 또는 위치가 잘못되었습니다. 적절한 사용법은 문서를 확인하세요.
XML 파싱 오류 … '…' 요소는 유형의 콘텐츠 유형이 요소 전용이므로 문자 [하위 요소]를 가질 수 없습니다. XML 파일에 잘못된 텍스트가 있습니다(< 또는 >가 누락된 태그로 인해 발생할 수 있음). 텍스트를 수정하고 다시 시도하세요.

위 목록에 없는 메시지를 이해하는 데 문제가 있는 경우 DSPL 포럼에 메시지를 게시해 주시면 도와드리겠습니다.

데이터 세트를 가져오는 데 성공했지만 공개 데이터 탐색기에 시각화가 표시되지 않습니다. 어떤 문제인가요?

이 문제는 데이터 세트가 유효한 DSPL이지만 공개 데이터 탐색기에서 시각화할 수 있는 DSPL의 하위 집합에 없는 경우에 발생합니다. 이 문제의 원인은 여러 가지가 있을 수 있으며 가장 일반적인 원인은 다음과 같습니다.

  • 테이블 없이 측정기준 개념 정의: 이 정보가 없으면 공개 데이터 탐색기에서 UI에 표시할 선택사항을 알 수 없습니다.
  • 측정항목만 있는 데이터 세트 만들기: 공개 데이터 탐색기에서 시각화 UI를 올바르게 구성하려면 데이터 세트의 어딘가에 정의된 카테고리(즉, 시간 외) 측정기준이 하나 이상 필요합니다.
  • 슬라이스에 시간 측정기준을 포함하지 않음: 공개 데이터 탐색기는 시계열만 시각화할 수 있습니다. 시간이 아닌 슬라이스는 제품에서 무시됩니다.
  • 표준 time:... 이외의 시간 측정기준 사용: 공개 데이터 탐색기는 표준 time 개념을 사용하여 제품의 다양한 시각화를 배치하고 애니메이션화합니다. 자체 데이터 세트 내에서 생성된 개념과 같은 다른 시간 개념은 이해하지 못합니다.
  • 너무 크거나 작은 시간 값 사용: 공개 데이터 탐색기는 아직 하루보다 작은 시간 단위의 데이터 세트를 시각화하지 않습니다. 반면 이 도구는 매우 큰 연도 값(예: 수만)을 처리하는 데 문제가 있습니다. 향후 이러한 세분화 수준을 더 유연하게 만들고자 합니다.

시각화된 데이터 세트를 웹사이트에 통합하려면 어떻게 해야 하나요?

공개 데이터 탐색기 고객센터의 이 도움말을 참고하세요. 후자에서 설명한 대로 삽입 URL을 수동으로 조정하여 '전체 삽입'(즉, 탐색 컨트롤을 포함하는 삽입)을 가져올 수 있습니다.