Набор данных

CSV

Текстовые файлы с табличными данными, опционально с геометриями. Вместо геометрий могут быть указаны названия местоположений. Все поля будут загружены в виде строк.

Параметры CSV
Параметр	Тип	Использование	Описание
url	строка	по умолчанию: Нет.	URL-адрес файла, содержащего данные. Допускаются только URL-адреса с использованием протоколов HTTPS или LIB. Можно использовать файлы из источников данных в пространстве приложения, используя следующий синтаксис: lib://DataFiles/<имя файла>. Например, lib://DataFiles/Offices.csv. Также можно указать пространство, где хранятся файлы, используя следующий синтаксис: lib://<имя пространства>:DataFiles/<имя файла>. Например, lib://EuropeSales:DataFiles/Offices.csv. Также можно указать файл из коннектора поставщика веб-хранилища, используя синтаксис: lib://<поставщик веб-хранилища>/<имя файла>. Например, lib://Dropbox/Offices.csv.
keyField	строка	по умолчанию: Нет.	Имя поля, содержащего идентификаторы для каждой геометрии. Если оставить поле пустым, будет создано ключевое поле.
geometryField	строка	по умолчанию: нет.	Имя поля геометрии, если таковое имеется. В качестве альтернативы для геометрии может быть задан столбец с общеизвестными точками или областями, см. «Тип геометрии» ниже. Если данные о точке находятся в двух полях, укажите в следующем формате имя поля широты, затем через запятую имя поля долготы.
geometryType	строка	по умолчанию: POINT	Тип геометрии в поле геометрии. Разрешенные значения: Point — геометрия точки, в формате точки Qlik Sense: «[долгота,широта] PointLatLon — одно поле для значений широты и одно поле для значений долготы Line — геометрия линии в формате Qlik Sense «[[долгота,широта],[долгота,широта],...]» Polygon — геометрия многоугольника, т. е. массив замкнутых линий или массив массивов замкнутых линий в случае нескольких многоугольников. LocationNamedPoint — название географического пункта, такого как город LocationNamedArea — название географической области, такой как страна WKT — геометрия в формате WKT, поддерживает POINT, LINESTRING, MULTILINESTRING, POLYGON и MULTIPOLYGON, см. раздел Общеизвестное текстовое представление геометрии В случае именованных точек или областей поиск геометрии выполняется в службе определения местоположения и добавляется столбец для геометрии. Добавляются столбцы для страны, типа, административных областей, как в наборе данных «Стандартные области и точки».
suffix	строка	по умолчанию: None.	Для продвинутых пользователей. Указанная строка добавляется ко всем идентификаторам. Это удобный способ указать дополнительную информацию для серверных служб определения местоположения, например код страны или тип. Альтернативный вариант — добавлять дополнительные данные при загрузке таблицы в Qlik. При использовании следующего суффикса все элементы задаются как города в Швеции: ,SE:city См. Спецификацию служб геометрии (только английский язык) для получения дополнительных сведений о том, какой синтаксис следует использовать.
header	строка	по умолчанию: Нет.	Имена столбцов, разделенные запятой. Если параметр не задан, то первая строка будет содержать заголовок.
fieldSeparator	строка	по умолчанию:TAB	Символ, разделяющий поля. Помимо обычных символов разрешены ключевые слова TAB, NEWLINE, COMMA и SEMICOLON.
recordSeparator	строка	по умолчанию: NEWLINE	Символ, разделяющий строки. Помимо обычных символов разрешены ключевые слова TAB, NEWLINE, COMMA и SEMICOLON.
encoding	строка	default:UTF-8	Набор символов для файла. Разрешены те же значения, что и в Java.
stringQuotes	строка	по умолчанию: Нет.	Символ, который может использоваться для заключения строк в кавычки. Разделители полей и записей внутри кавычек не будут восприниматься как таковые. Кавычки будут удалены в импортированных данных. Помимо обычных символов разрешены ключевые слова QUOTE("), DOUBLEQUOTE(") и SINGLEQUOTE(').
crs	строка	по умолчанию: Auto	Базовая система координат (CRS) загружаемых данных. Перед загрузкой в приложение данные будут спроецированы из этой CRS в WGS84 (EPSG:4326). Если задано значение Авто, используется EPSG:4326 (WGS84).

GEOFILE

Загружает различные форматы географических файлов, такие как GeoJSON и ESRI Shapefile.

В этом примере загружается файл GeoJSON с помощью операции Simplify:

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-адрес файла, содержащего данные. Допускаются только URL-адреса с использованием протоколов HTTPS или LIB. Можно использовать файлы из источников данных в пространстве приложения, используя следующий синтаксис: lib://DataFiles/<имя файла>. Например, lib://DataFiles/SalesGeographies.geojson. Также можно указать пространство, где хранятся файлы, используя следующий синтаксис: lib://<имя пространства>:DataFiles/<имя файла>. Например, lib://EuropeSales:DataFiles/SalesGeographies.geojson. Также можно указать файл из коннектора поставщика веб-хранилища, используя синтаксис: lib://<поставщик веб-хранилища>/<имя файла>. Например, lib://Dropbox/SalesGeographies.geojson.
keyField	строка	по умолчанию: Нет.	Имя поля, содержащего идентификаторы для каждой геометрии. Если оставить поле пустым, будет создано ключевое поле.
type	строка	по умолчанию: Auto	Тип файла. Разрешенные значения: Auto — пытается определить тип файла по его имени. GeoJSON — формат GeoJSON согласно определению на веб-сайте geojson.org. GML — для чтения файлов GML или подключения к службам WFS. Читает файлы featureCollection и создает по одной строке из каждого элемента featureMember. GeoOperations поддерживает только GML2. Shape — файл zip, содержащий как минимум файлы shp и dbf для формата шейп-файлов ESRI. Важно, чтобы файл zip был создан с той же кодировкой символов, что и содержащиеся в нем файлы. ESRIJson — JSON в формате, возвращаемом ESRI ArcGIS Server (см. документ ESRI о формате). Это позволяет подключаться к ArcGIS и импортировать данные из опубликованных им служб. DXF — для чтения геометрий из файла DXF AutoCAD. Поддерживается ограниченный набор типов объектов для точек и линий: `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

Таблица, которая передается как входные данные для функции Extension, может быть объявлена, чтобы указать, как ее следует интерпретировать. Если она не объявлена, ключевое поле и поле геометрии во многих случаях могут быть автоматически определены на основе содержимого. Однако рекомендуется объявлять таблицы, чтобы интерпретация не менялась после перезагрузки с новыми данными.

Если в таблице вместо геометрий или столбцов широты и долготы содержатся названия, таблицу необходимо объявить.

Если таблица не объявлена, она будет считаться первой таблицей для наборов данных по умолчанию в операциях. Если она объявлена, она будет считаться в том порядке, в котором она объявлена.

Обычно используется формат геометрии Qlik Sense, но формат WKT (Общеизвестное текстовое представление геометрии) также поддерживается. Это позволяет считывать географические данные из базы данных с помощью одного из обычных коннекторов базы данных и затем преобразовывать геометрии в формат Sense с помощью операции Load. Обратите внимание, что при чтении геометрии из базы данных следует применять функцию, возвращающую столбец в формате WKT. Стандартная функция SQL называется ST_AsText(), но некоторые базы данных имеют свою собственную функцию.

Одновременно может использоваться только один из параметров, определяющих поле местоположения, за исключением параметров latitudeField и longitudeField, которые всегда должны определяться попарно.

Для каждой операции можно указать только одну встроенную таблицу. Если требуется использовать данные в двух или более встроенных таблицах, можно использовать 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	строка	дополнительно	Имя поля, содержащего идентификаторы для каждой строки. Если оно не указано, будет добавлен столбец ключа _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 — уникальный ИД для каждого объекта
LocationPoint/LocationArea — геометрия объекта
CountryIso2 — двухбуквенный код страны
Adm1Code — национальный код административной области первого порядка
Adm2Code — национальный код административной области второго порядка
LocationDbType — дополнительные сведения о типах см. в Спецификации служб геометрии (только английский язык)

В этом примере загружаются штаты в США:

MyAirports: Load * Extension GeoOperations.ScriptEval(' Load() DATASOURCE states LOCATIONSERVICE geometry="AREA", type="STATE", country="us" ');

Параметры LOCATIONSERVICE
Параметр	Тип	Использование	Описание
geometry	строка	по умолчанию: Area	Выберите для доступа к точкам (Point) или областям (Area).
type	строка	по умолчанию: Country	Тип данных, которые представляют названия, например страны, административные области, почтовые индексы и т. д. Следующие упрощенные имена типов могут быть использованы (без учета регистра) в собственных типах в базе данных местоположений: CONTINENT — название континента COUNTRY — название страны COUNTRYISO2 — код ISO 3166-1 alpha-2 COUNTRYISO3 — код ISO 3166-1 alpha-2 ADMIN1 — административная единица первого порядка STATE — псевдоним для ADMIN1 ADMIN2 — административная единица второго порядка. ADMIN3 — административная единица третьего порядка. ADMIN4 — административная единица четвертого порядка. POSTALCODE — почтовый индекс ZIP — псевдоним для POSTALCODE CITY — название города AIRPORTIATA — код ИАТА для аэропорта AIRPORTICAO — код ИКАО для аэропорта Дополнительные сведения о подробных типах см. в Спецификации служб геометрии (только английский язык).
country	строка	по умолчанию: Нет.	Код страны (2 или 3 буквы) для страны, к которой необходимо получить доступ. Можно указать несколько стран, разделив их запятой. Значение по умолчанию означает, что страна не ограничена.

CSV

GEOFILE

INTABLE

LOCATIONSERVICE

Помогла ли вам эта страница?