기본 콘텐츠로 건너뛰기 보완적인 콘텐츠로 건너뛰기

데이터 집합

다음은 Qlik GeoOperations 서버 측 확장에서 작업과 함께 사용할 수 있는 데이터 소스입니다.

CSV

테이블 데이터가 있는 텍스트 파일이며 선택적으로 도형이 있습니다. 도형 대신 위치 이름을 지정할 수 있습니다. 모든 필드는 문자열로 로드됩니다.
CSV에 대한 매개 변수
매개 변수 유형 사용 설명
url 문자열 기본값: 없음.

데이터가 포함된 파일의 URL입니다. HTTPS 또는 LIB 프로토콜을 사용하는 URL만 허용됩니다.

lib://DataFiles/<파일 이름> 구문을 사용하여 앱 공간에서 데이터 소스의 파일을 사용할 수 있습니다. 예: lib://DataFiles/Offices.csv. lib://<공간 이름>:DataFiles/<파일 이름> 구문을 사용하여 파일을 저장하는 공간을 지정할 수도 있습니다. 예: lib://EuropeSales:DataFiles/Offices.csv. lib://<웹 저장소 공급자>/<파일 이름> 구문을 사용하여 웹 저장소 공급자 커넥터에서 파일을 지정할 수도 있습니다. 예: lib://Dropbox/Offices.csv.

keyField 문자열 기본값: 없음. 각 도형에 대한 ID를 포함하는 필드의 이름입니다. 필드를 비워두면 키 필드가 생성됩니다.
geometryField 문자열 기본값: 없음. 도형 필드의 이름(있는 경우)입니다. 도형에 대한 대안으로 포인트 또는 영역의 잘 알려진 이름이 있는 열을 아래에 "도형 유형"으로 지정할 수 있습니다. 포인트 데이터가 두 필드에 있는 경우 위도 필드 이름 쉼표 경도 필드 이름 형식으로 지정합니다.
geometryType 문자열 기본값: POINT 도형 필드의 도형 유형입니다. 허용되는 값은 다음과 같습니다.
  • Point - Qlik Sense 포인트 형식의 포인트 도형: "[경도,위도]"
  • PointLatLon - 위도가 있는 필드와 경도가 있는 필드
  • Line - Qlik Sense 선 형식의 선 도형: "[[경도, 위도],[경도, 위도],...]"
  • Polygon - 다각형 도형, 즉 다중 다각형의 경우 닫힌 선 배열 또는 닫힌 선 배열의 배열
  • LocationNamedPoint - 도시와 같은 지리적 포인트의 이름
  • LocationNamedArea - 국가와 같은 지리적 영역의 이름
  • WKT - WKT 형식의 도형, POINT, LINESTRING, MULTILINESTRING, POLYGON 및 MULTIPOLYGON 지원, 도형의 잘 알려진 텍스트 표현 참조
이름이 지정된 포인트 또는 영역의 경우 위치 서비스에서 도형이 조회되고 도형에 대한 열이 추가됩니다. 국가, 유형 및 행정 구역에 대한 열은 표준 영역 및 포인트 데이터 집합에서와 같이 추가됩니다.
suffix 문자열 기본값: 없음. 고급 사용자용입니다. 지정된 문자열이 모든 ID에 추가됩니다. 이는 국가 코드 또는 유형과 같은 서버 기반 위치 서비스에 더 많은 정보를 지정하는 편리한 방법입니다. 대안으로 테이블을 Qlik에 로드할 때 데이터를 더 추가할 수도 있습니다. 다음 접미사를 사용하면 모든 항목이 스웨덴의 도시로 지정됩니다.
,SE:city
사용할 구문에 대한 자세한 내용은 도형 서비스 사양 (영어로만 제공)을 참조하십시오.
header 문자열 기본값: 없음. 쉼표로 구분된 열의 이름입니다. 비어 있으면 첫 번째 행에 머리글이 포함됩니다.
fieldSeparator 문자열 기본값: TAB 필드를 구분하는 문자입니다. 일반 문자 외에도 TAB, NEWLINE, COMMA 및 SEMICOLON이라는 키워드가 허용됩니다.
recordSeparator 문자열 기본값: NEWLINE 줄을 구분하는 문자입니다. 일반 문자 외에도 TAB, NEWLINE, COMMA 및 SEMICOLON이라는 키워드가 허용됩니다.
encoding 문자열 기본값:UTF-8 파일의 문자 집합입니다. Java에서와 동일한 값이 허용됩니다.
stringQuotes 문자열 기본값: 없음. 문자열을 묶는 데 사용할 수 있는 문자입니다. 따옴표 안에 있는 필드 및 레코드 구분 기호는 구문 분석되지 않습니다. 가져온 데이터에서 따옴표가 제거됩니다. 일반 문자 외에도 키워드 QUOTE("), DOUBLE QUOTE(") 및 SINGLE QUOTE(')가 허용됩니다.
crs 문자열 기본값: Auto 로드할 데이터의 CRS(좌표 참조 시스템)입니다. 데이터는 앱에 로드되기 전에 이 CRS에서 WGS84(EPSG:4326)로 프로젝션됩니다.

Auto로 설정하면 EPSG:4326(WGS84)이 사용됩니다.

GEOFILE

GeoJSON 및 ESRI Shapefile과 같은 다양한 종류의 지리 파일 형식을 로드합니다.

이 예에서는 Simplify 작업을 통해 GeoJSON 파일을 로드합니다.

Load * Extension GeoOperations.ScriptEval(' SELECT nuts.NUTS_ID as NUTS_ID, Simplified_nuts_Geometry FROM Simplify() DATASOURCE nuts GEOFILE url="https://datahub.io/core/geo-nuts-administrative-boundaries/r/nuts_rg_60m_2013_lvl_1.geojson"');
GEOFILE에 대한 매개 변수
매개 변수 유형 사용 설명
url 문자열 기본값: 없음.

데이터가 포함된 파일의 URL입니다. HTTPS 또는 LIB 프로토콜을 사용하는 URL만 허용됩니다.

lib://DataFiles/<파일 이름> 구문을 사용하여 앱 공간에서 데이터 소스의 파일을 사용할 수 있습니다. 예: lib://DataFiles/SalesGeographies.geojson. lib://<공간 이름>:DataFiles/<파일 이름> 구문을 사용하여 파일을 저장하는 공간을 지정할 수도 있습니다. 예: lib://EuropeSales:DataFiles/SalesGeographies.geojson. lib://<웹 저장소 공급자>/<파일 이름> 구문을 사용하여 웹 저장소 공급자 커넥터에서 파일을 지정할 수도 있습니다. 예를 들어, lib://Dropbox/SalesGeographies.geojson입니다.

keyField 문자열 기본값: 없음. 각 도형에 대한 ID를 포함하는 필드의 이름입니다. 필드를 비워두면 키 필드가 생성됩니다.
type 문자열 기본값: Auto 파일 유형입니다. 허용되는 값은 다음과 같습니다.
  • Auto - 파일 이름에서 파일 유형 감지를 시도합니다.
  • GeoJSON - geojson.org에서 지정한 GeoJSON 형식입니다.
  • GML - GML 파일을 읽거나 WFS 서비스에 연결합니다. featureCollection 파일을 읽고 각 featureMember 요소의 한 행을 만듭니다. GeoOperations는 GML2만 지원합니다.
  • Shape - ESRI Shape 파일 형식에 대해 최소한 shp 및 dbf 파일이 있는 zip 파일입니다. zip 파일은 포함된 파일과 동일한 문자 인코딩으로 만들어야 합니다.
  • ESRIJson - ESRI ArcGIS Server에서 반환된 JSON(ESRI 문서 형식 참조)입니다. 이를 통해 ArcGIS에 연결하고 게시한 서비스에서 데이터를 가져올 수 있습니다.
  • DXF - AutoCAD DXF 파일에서 도형을 읽습니다. 포인트 및 선에 대한 제한된 엔터티 유형 집합이 지원됩니다. POINT, TEXT, MTEXT, ARC, CIRCLE, LINE, POLYLINE, LWPOLYLINE, SPLINE, and MLINE
encoding 문자열 기본값: 없음. 일부 형식(예: ESRI Shapefile)의 경우 문자 인코딩이 형식에 정의되어 있지 않습니다. 이 방법을 통해 이 정보를 제공할 수 있습니다. 대부분의 형식에서 이 속성은 무시됩니다.
expectedGeomType 문자열 기본값: Auto 한 번에 하나의 도형 유형만 로드됩니다. 데이터에 여러 유형이 있는 경우 이 속성을 사용하여 로드할 유형을 설정합니다. 여러 유형을 지원하지 않는 형식의 경우 이 매개 변수는 무시됩니다.
  • Auto - 자동으로 유형 감지를 시도합니다.
  • Point - 지정된 파일에서 포인트를 찾습니다.
  • Line - 지정된 파일에서 선을 찾습니다.
  • Polygon - 지정된 파일에서 다각형을 찾습니다.
crs 문자열 기본값: Auto 로드할 데이터의 CRS(좌표 참조 시스템)입니다. 데이터는 앱에 로드되기 전에 이 CRS에서 WGS84(EPSG:4326)로 프로젝션됩니다.

Auto로 설정하거나 비어 있으면 파일에서 구문 분석을 시도합니다. 파일에 CRS가 없으면 EPSG:4326(WGS84)이 사용됩니다. 이를 CRS로 설정하면 파일의 정보가 무시되며 해당 정보가 없거나 잘못된 것으로 알려진 파일에 대해서만 수행해야 합니다. 여러 CRS가 있는 데이터가 있는 파일은 지원되지 않습니다.

INTABLE

확장 기능에 대한 입력으로 전달되는 테이블을 선언하여 해석 방법을 지정할 수 있습니다. 선언하지 않으면 키 필드와 도형 필드가 내용에 따라 자동으로 감지되는 경우가 많습니다. 그러나 새 데이터로 다시 로드한 후 해석이 변경되지 않도록 테이블을 선언하는 것이 좋습니다.

테이블에 도형 또는 위도 및 경도 열 대신 이름이 포함된 경우 이를 선언해야 합니다.

테이블이 선언되지 않은 경우 작업에서 기본 데이터 집합에 대한 첫 번째 테이블로 계산됩니다. 선언된 경우 선언된 순서대로 계산됩니다.

일반적으로 Qlik Sense 도형 형식이 사용되지만 WKT 형식(도형의 잘 알려진 텍스트 표현)도 지원됩니다. 이렇게 하면 일반적인 데이터베이스 커넥터 중 하나를 사용하여 데이터베이스에서 지리 데이터를 읽은 다음 Load 작업을 사용하여 도형을 Sense 도형으로 변환할 수 있습니다. 데이터베이스에서 도형을 읽을 때 WKT 형식으로 열을 반환하는 함수를 적용해야 합니다. 표준 SQL 함수는 ST_AsText()라고 하지만 일부 데이터베이스에는 자체 함수가 있습니다.

항상 쌍으로 정의되어야 하는 latitudeFieldlongitudeField를 제외하고 위치 필드를 지정하는 매개 변수 중 하나만 사용할 수 있습니다.

작업당 하나의 인라인 테이블만 지정할 수 있습니다. 둘 이상의 인라인 테이블에서 데이터를 사용해야 하는 경우 STORE를 사용하여 다른 인선 테이블을 CSV 파일로 저장한 다음 CSV 파일에서 로드할 수 있습니다.

위도 및 경도 필드의 예:

MyCities: LOAD * inline " cid;lat;long 1;57.7;12 2;45.42;-75.70 " (delimiter is ';'); Load * Extension GeoOperations.ScriptEval(' TravelAreas(costValue="10",costUnit="minutes") DATASOURCE cities INTABLE keyField="cid", latitudeField="lat", longitudeField="long"', MyCities);
데이터에 이름이 지정된 위치가 포함되어 있고 그 때문에 namedAreaField 매개 변수를 선언해야 하는 예:
MyCountries: LOAD * inline " cid;Country 1;US 2;CA " (delimiter is ';'); Load * Extension GeoOperations.ScriptEval(' Simplify() DATASOURCE countries INTABLE keyField="Country", namedAreaField="Country"', MyCountries{Country});
INTABLE에 대한 매개 변수
매개 변수 유형 사용 설명
keyField 문자열 선택 사항 각 행에 대한 고유 ID를 포함하는 필드의 이름입니다. 지정하지 않으면 _autoIndex_라는 키 열이 각 행에 대해 고유한 값과 함께 추가됩니다.
pointField 문자열 선택 사항 Qlik Sense 포인트 형식 "[경도, 위도]"의 포인트 데이터가 포함된 필드입니다. WKT 포인트 데이터("POINT(...)")도 지원됩니다.
lineField 문자열 선택 사항 Qlik Sense 선 형식 "[[경도,위도],[경도,위도],...]"의 선 데이터를 포함하는 필드입니다. WKT 선 데이터("LINESTRING(...)" 또는 "MULTILINESTRING(...)")도 지원됩니다.
polygonField 문자열 선택 사항 Sense 다각형 형식의 선 데이터를 포함하는 필드, 즉 다중 다각형의 경우 닫힌 선 배열 또는 닫힌 선 배열의 배열입니다. WKT 다각형 데이터("POLYGON(...)" 또는 "MULTIPOLYGON(...)")도 지원됩니다.
latitudeField 문자열 선택 사항 위도 값이 포함된 필드입니다.
longitudeField 문자열 선택 사항 경도 값이 포함된 필드입니다.
namedPointField 문자열 선택 사항 위치 데이터베이스에서 조회되는 지리적 특징의 이름을 포함하는 필드입니다. 이름은 포인트로 표시됩니다.
namedAreaField 문자열 선택 사항 위치 데이터베이스에서 조회되는 지리적 특징의 이름을 포함하는 필드입니다. 이름은 다각형으로 표시됩니다. 위치 데이터베이스의 모든 이름에 연결된 다각형이 있는 것은 아닙니다.
crs 문자열 기본값: Auto 로드할 데이터의 CRS(좌표 참조 시스템)입니다. 데이터는 앱에 로드되기 전에 이 CRS에서 WGS84(EPSG:4326)로 프로젝션됩니다.

Auto로 설정하면 EPSG:4326(WGS84)이 사용됩니다.

LOCATIONSERVICE

Qlik GeoAnalytics Server 위치 서비스에서 사용할 수 있는 포인트 및 영역입니다. 유형 또는 국가를 지정해야 합니다.

위치 서비스에서 로드된 테이블의 필드는 다음과 같습니다.

  • LocationDbId - 각 엔터티에 대한 고유 ID입니다.
  • LocationPoint/LocationArea - 엔터티의 도형입니다.
  • CountryIso2 - 2 문자 국가 코드입니다.
  • Adm1Code - 1단계 행정 구역의 국가별 코드입니다.
  • Adm2Code - 2단계 행정 구역의 국가별 코드입니다.
  • LocationDbType - 유형에 대한 자세한 내용은 도형 서비스 사양 (영어로만 제공)을 참조하십시오.

이 예에서는 미국의 주를 로드합니다.

MyAirports: Load * Extension GeoOperations.ScriptEval(' Load() DATASOURCE states LOCATIONSERVICE geometry="AREA", type="STATE", country="us" ');
LOCATIONSERVICE에 대한 매개 변수
매개 변수 유형 사용 설명
geometry 문자열 기본값: Area 포인트 또는 영역에 액세스하도록 선택합니다.
type 문자열 기본값: Country 국가, 행정 구역, 우편 번호 등과 같이 이름이 나타내는 데이터 유형입니다. 위치 데이터베이스의 기본 유형에서 다음과 같은 단순화된 유형 이름을 사용할 수 있습니다(대/소문자 구분 안 함).
  • CONTINENT - 대륙 이름입니다.
  • COUNTRY - 국가 이름입니다.
  • COUNTRYISO2 - ISO 3166-1 alpha-2 코드입니다.
  • COUNTRYISO3 - ISO 3166-1 alpha-2 코드입니다.
  • ADMIN1 - 1차 행정 구획입니다.
  • STATE - ADMIN1의 별칭입니다.
  • ADMIN2 - 2단계 행정 구획입니다.
  • ADMIN3 - 3단계 행정 구획입니다.
  • ADMIN4 - 4단계 행정 구획입니다.
  • POSTALCODE - 우편 번호입니다.
  • ZIP - POSTALCODE의 별칭입니다.
  • CITY - 도시 이름입니다.
  • AIRPORTIATA - 공항 IATA 코드입니다.
  • AIRPORTICAO - 공항 ICAO 코드입니다.
세부 유형에 대한 자세한 내용은 도형 서비스 사양 (영어로만 제공)을 참조하십시오.
country 문자열 기본값: 없음. 액세스할 국가의 국가 코드(2자 또는 3자)입니다. 여러 국가를 쉼표로 구분하여 지정할 수 있습니다. 기본값은 국가로 제한되지 않음을 의미합니다.
 

이 페이지가 도움이 되었습니까?

이 페이지 또는 해당 콘텐츠에서 오타, 누락된 단계 또는 기술적 오류와 같은 문제를 발견하면 개선 방법을 알려 주십시오!