DSPL 설명서

이 문서에는 유용한 DSPL 및 표준 개념에 대한 설명서가 포함되어 있습니다. '레시피'입니다. 여기에는 다양한 마케팅 전략과 위의 기본 언어 기능을 뛰어넘는 튜토리얼 및 개발자 가이드를 참고하세요. 콘텐츠 아래 내용은 이전 문서에 대한 지식을 전제로 하므로 몇 가지 예가 있습니다.

각 레시피는 목표로 시작해서 요리에 필요한 특정 단계 목록이 있습니다. 또한 대부분 DSPL 스니펫이나 외부 예시 링크도 포함하고 있습니다. 만약 레시피에 대한 의견이 있거나 다른 사람을 제안하고 싶은 경우 DSPL 포럼에 질문을 올려도 됩니다.

기본 레시피

표시 이름 지정

목표

'표시 이름' 연결 (측정기준)의 각 인스턴스와 있습니다. 이 이름은 공개 데이터 탐색기 UI에 표시되며 일반적으로 더 짧고 사용자가 이해하기 어려운 개념 인스턴스 ID입니다. 이해할 수 있습니다

단계

1. entity:entity. 확장 개념 만들기
2. 연결된 개념 정의에 name 열 추가 표에서 볼 수 있습니다.
3. 후자의 속성에 각 인스턴스의 이름을 입력합니다.

참고

• name 속성을 명시적으로 정의할 필요는 없습니다. 개념 메타데이터 이 정의는 맞춤 측정기준을 만들 때 entity:entity를 확장합니다.
• description 및 info_url도 추가할 수 있습니다. 열을 사용하여 각각 인스턴스 수준 설명과 URL을 제공합니다.

개념 계층 구조 만들기

목표

(측정기준) 개념의 계층 구조를 만듭니다. 이러한 정보는 사용자가 그룹을 이해할 수 있도록 트리 형태의 공개 데이터 탐색기 UI 이미지 간에 이동할 수 있습니다.

단계

1. '상위 요소' 정의 개념 (예: region)
2. '하위 요소' 정의 개념 (예: subregion)
3. 상위 요소를 참조하고 isParent 속성:

   <property concept="..." isParent="true"/>
   

   여기서 점이 상위 ID로 대체됩니다.
4. 하위 요소에 대한 정의 테이블에서, 하위 요소에 대한 있습니다.
5. 각 하위 인스턴스에 대해 후자를 유효한 인스턴스로 채웁니다. 상위 개념입니다.

참고

• country / state 관계는 다음을 참고하세요. 튜토리얼 데이터 세트에서 예를 살펴보겠습니다
• 하위 요소에서 참조된 각 상위 ID는 상위 요소의 정의합니다. 그렇지 않으면 가져오기 도구가 오류를 발생시킵니다.
• 상위 요소와 하위 요소가 동일한 개념일 수 있습니다 (즉, 자체 참조 계층 구조). business 개념은 미국 소매 판매 데이터 세트 를 참조하세요.

개념 인스턴스 분류

목표

옵션으로 표시될 개념 인스턴스에 대한 카테고리를 만듭니다. 공개 데이터 탐색기 색상 선택 도구에 표시됩니다.

단계

1. '카테고리' 정의 개념 (예: income_level)
2. '하위 요소' 정의 개념 (예: country)
3. 하위 요소에 카테고리 개념을 참조하는 속성을 추가하고 여기에는 name 요소:

   <property concept="..."/>
     <info>
       <name><value>"..."</value></name>
     </info>
   </property>
   

   여기서 첫 번째 점 집합은 카테고리 개념 ID로 대체됩니다. 두 번째 집합은 속성에 대해 원하는 표시 이름으로 대체됩니다. (예: '소득 수준')
4. 하위 요소에 대한 정의 테이블에서, 하위 요소에 대한 있습니다.
5. 각 하위 인스턴스에 대해 후자를 유효한 인스턴스로 채웁니다. 카테고리 개념입니다.

참고

• 하나의 개념에는 카테고리 역할을 하는 여러 속성이 있을 수 있습니다. 이 이 경우 사용자에게는 모두 색상 선택 도구의 옵션으로 표시됩니다.
• 카테고리 중 하나가 UI에서 인스턴스를 계층적으로 구성할 수 있습니다 이전 참조하세요.

개념 인스턴스의 정렬 순서 지정

목표

개념의 인스턴스에 대한 정렬 순서를 지정합니다. 이 주문은 다음과 같은 경우에 사용됩니다. Public Data Explorer의 왼쪽 탐색 메뉴에 인스턴스 나열 시각화 페이지로 이동합니다

단계

1. 개념이 entity:entity 또는 다음 중 하나를 확장하도록 합니다. 아동 (예: geo:location))를 제공합니다.
2. 개념 메타데이터에 entity_order 속성을 추가합니다.
3. 이전 값을 ALPHA 또는 TABLE 전자를 사용하면 인스턴스가 목록에 표시 이름의 순서를 사용하고 후자는 인스턴스를 유지합니다. 개념 정의 표에 표시된 것과 동일한 순서로 표시됩니다.

참고

• ALPHA가 현재 기본값이므로 이 옵션을 사용하려면 위 단계는 선택사항입니다.
• entity:entity 문서를 참고하세요.

시간 레시피

분기별 데이터

목표

분기별 간격으로 지정된 데이터를 시각화합니다.

단계

1. 슬라이스 데이터의 모든 분기를 월로 변환합니다 (예: 분기 첫 달).
2. 이 측정기준을 슬라이스의 time:month로 처리합니다. XML입니다.

주간 데이터

목표

매주 지정된 데이터를 시각화합니다.

단계

1. 슬라이스 데이터의 모든 주를 일 단위로 변환합니다 (예: 첫 번째 주 요일).
2. 이 크기는 슬라이스 XML에서 time:day로 처리합니다.

Geo 레시피

country 또는 state 사용 표준 개념

목표

표준 country 또는 state 개념을 사용합니다. 모든 위도/경도 값 등을 가져와서 데이터 세트 내에서 정의됩니다.

단계

1. 모든 국가 및/또는 미국 주 참조가 슬라이스 데이터 CSV는 표준 국가 및 주 정의하는 데 도움이 됩니다
2. geo:country 또는 geo_us:state를 다음 이름으로 추가 슬라이스의 크기가 포함됩니다.
3. 열의 이름이 이름과 일치하는지 확인하세요. (가져온 데이터 세트 이름은 포함되지 않음. 예: country) 또는 포함되지 않은 경우 mapDimension 포함 슬라이스 정의에 포함되어야 합니다. 예:

   <slice id="...">
     ...
     <dimension concept="geo:country"/>
     ...
     <mapDimension concept="geo:country" toColumn="my_country"/>
   </slice>
   

표준 국가의 하위 집합만 사용하거나 주

목표

표준 지역 개념의 하위 집합을 사용하여 이 하위 집합만 전체 목록(예: 모든 국가)가 '공개 목록'에 데이터 탐색기 UI.

단계

1. 상위 집합 개념을 확장하는 지역 개념을 정의합니다. 예시:

   <concept id="my_country_subset" extends="geo:country">
   ...
   </concept>
   

2. 관련 개념 정의 CSV에 상위 집합 개념입니다. 예시:

   my_country_subset
   FR  
   MX
   US
   

참고

• 하위 집합 개념의 각 인스턴스는 상위 집합 개념 '펼칠' 수는 없습니다. 개념을 인스턴스

고유한 지리 개념 정의

목표

탐색 및 매핑이 가능한 고유한 지리 개념을 만들 수 있습니다. Google에서 정의한 표준 URL과 같은 경우가 많습니다

단계

1. geo:location를 확장하는 개념을 만듭니다.
2. 연결된 개념 정의 표에 다음 열을 포함합니다. name, latitude, longitude
3. 개념의 각 인스턴스에 대해 후자의 속성을 채웁니다. 위도 및 경도 값은 N 및 E 양성이고 W와 S는 음수입니다.

참고

• name를 명시적으로 포함할 필요는 없습니다. latitude 및 longitude 속성을 확장 시 자동으로 포함되므로 geo:location입니다.
• 튜토리얼 데이터 세트에서 state의 정의를 확인하세요. 예로 들 수 있습니다

미터법 및 단위 레시피

퍼센트 사용

목표

다른 부분의 비율인 (측정항목) 개념을 정의합니다.

단계

1. 개념이 quantity:ratio를 확장하도록 합니다.
2. is_percentage 속성을 true으로 설정합니다.

   <attribute id="is_percentage">
     <value>true</value>
   </attribute>
   

3. 필요한 경우 percentage_of 속성을 설정하는 대상 백분율로 표시됩니다. 예:

   <attribute id="percentage_of">
     <value>labor force</value>
   </attribute>
   

currency 단원 사용

목표

통화 단위를 사용하는 (측정항목) 개념을 정의합니다 (예: 미국 달러).

단계

1. 측정항목을 quantity:quantity 또는 다음 중 하나를 확장하세요. 아동(예: quantity:amount입니다.
2. 다음을 참조하는 unit 속성 추가 unit:currency로 설정하고 이 값을 관련 통화 정의 표를 참조하세요. 예:

   <concept id="...">
     <attribute concept="unit:currency">
       <value>EUR</value>
     </attribute>
   </concept>
   

맞춤 단위 만들기

목표

하나 이상의 측정항목에 대한 맞춤 단위를 만듭니다.

단계

1. unit:unit를 확장하는 개념을 만듭니다.
2. unit_text 및 symbol 열을 다음과 같이 추가합니다. 관련 정의 테이블입니다. 선택사항으로, symbol_position를 추가할 수도 있습니다. 를 클릭합니다.
3. 각 인스턴스에 대한 후자의 속성 값을 입력합니다. 사용됩니다. '지역'에 대한 CSV 예 단위:

   my_unit,unit_text,symbol,symbol_position
   SQKM,square kilometers,km²,END
   SQML,square miles,miles²,END
   

4. 새로 만든 단위를 (측정항목) 개념에 사용하려면 후자는 quantity:quantity 또는 그 하위 요소 중 하나를 확장합니다. 그런 다음 단위 개념을 참조하는 속성을 추가합니다. 예:

   <concept id="..." extends="quantity:amount">
     ...
     <attribute concept="my_unit">
       <value>SQKM</value>
     </attribute>
     ...
   </concept>
   

참고

• 단위 개념에 인스턴스가 하나만 있는 경우 ID를 생략할 수 있습니다. 열의 value 태그와 확인할 수 있습니다
• 표준 통화의 정의를 참조하세요. 개념을 참조하세요.