Przeskocz do zawartości głównej Przejdź do treści uzupełniającej

Zestaw danych

Poniżej przedstawiono źródła danych, których można używać z operacjami w rozszerzeniu po stronie serwera Qlik GeoOperations.

CSV

Pliki tekstowe z danymi tabeli, opcjonalnie z geometriami. Zamiast geometrii można podać również nazwy lokalizacji. Wszystkie pola zostaną załadowane jako ciągi.
Parametry dotyczące CSV
Parametr Typ Użycie Opis
url ciąg znaków domyślnie: brak.

Adres URL pliku zawierającego dane. Dozwolone są tylko adresy URL z protokołami HTTPS lub LIB.

Możesz używać plików ze źródeł danych w przestrzeni aplikacji, używając następującej składni: lib://DataFiles/<nazwa pliku>. Na przykład lib://DataFiles/Offices.csv. Możesz również określić miejsce do przechowywania plików, używając następującej składni: lib://<nazwa przestrzeni>:DataFiles/<nazwa pliku>. Na przykład lib://EuropeSales:DataFiles/Offices.csv. Możesz również określić plik z Łącznika do dostawcy magazynowania w sieci Web, używając następującej składni: lib://<dostawca magazynowania w sieci Web>/<file name>. Na przykład lib://Dropbox/Offices.csv.

keyField ciąg znaków domyślnie: brak. Nazwa pola zawierającego tożsamości każdej geometrii. Jeśli pozostawisz to pole puste, zostanie wygenerowane pole kluczowe.
geometryField ciąg znaków domyślnie: brak. Nazwa pola geometrii, jeśli istnieje. Jako alternatywę dla geometrii można podać kolumnę z dobrze znanymi punktami lub obszarami jako „Typ geometrii” poniżej. Jeśli dane punktu znajdują się w dwóch polach, podaj je w następującym formacie: nazwa pola szerokości geograficznej przecinek nazwa pola długości geograficznej.
geometryType ciąg znaków domyślnie: POINT Typ geometrii w polu Geometry. Dozwolone wartości to:
  • Point — geometria punktu w formacie punktu Qlik Sense: „[długość geograficzna,szerokość geograficzna]”
  • PointLatLon — jedno pole z szerokościami geograficznymi i jedno z długościami geograficznymi
  • Line — geometria linii w formacie linii Qlik Sense: „[[długość geograficzna, szerokość geograficzna],[długość geograficzna, szerokość geograficzna],...]”
  • Polygon — geometria wielokąta, czyli tablica linii zamkniętych lub tablica tablic linii zamkniętych w przypadku wielokątów złożonych
  • LocationNamedPoint — nazwa punktu geograficznego np. miasto
  • LocationNamedArea — nazwa obszaru geograficznego np. kraj
  • WKT — geometria w formacie WKT, obsługuje POINT, LINESTRING, MULTILINESTRING, POLYGON i MULTIPOLYGON — zobacz: Well-known text representation of geometry
W przypadku nazwanych punktów lub obszarów geometria jest wyszukiwana w usłudze lokalizacji i dodawana jest kolumna dla geometrii. Dodawane są kolumny dla kraju, typu i obszarów administracyjnych, jak w zestawie danych standardowych obszarów i punktów.
suffix ciąg znaków domyślnie: brak. Dla użytkowników zaawansowanych. Podany ciąg jest dołączany do wszystkich identyfikatorów. Jest to wygodny sposób podawania dodatkowych informacji, takich jak kod kraju lub typ, do usług lokalizacyjnych opartych na serwerze. Alternatywą jest dołączanie dodatkowych danych podczas ładowania tabeli do Qlik. Przy użyciu następującego sufiksu wszystkie elementy określane są jako miasta w Szwecji:
,SE:city
Więcej informacji na temat składni można znaleźć w Specyfikacji usług geometrii (tylko w języku angielskim).
header ciąg znaków domyślnie: brak. Nazwy kolumn oddzielone przecinkiem. Jeśli są puste, pierwszy wiersz zawiera nagłówek.
fieldSeparator ciąg znaków domyślnie: TAB Znak oddzielający pola. Oprócz zwykłych znaków dozwolone są słowa kluczowe TAB, NEWLINE, COMMA i SEMICOLON.
recordSeparator ciąg znaków domyślnie: NEWLINE Znak oddzielający wiersze. Oprócz zwykłych znaków dozwolone są słowa kluczowe TAB, NEWLINE, COMMA i SEMICOLON.
encoding ciąg znaków default:UTF-8 Zestaw znaków pliku. Dozwolone są takie same wartości jak w języku Java.
stringQuotes ciąg znaków domyślnie: brak. Znak, którego można używać jako cudzysłowu do łańcuchów. Separatory pól i rekordów wewnątrz cudzysłowów nie będą analizowane jako separatory. Cudzysłowy zostaną usunięte z importowanych danych. Oprócz zwykłych znaków dozwolone są słowa kluczowe QUOTE("), DOUBLEQUOTE(") i SINGLEQUOTE(').
crs ciąg znaków domyślnie: Auto Układ CRS (Coordinate Reference System) danych do załadowania. Dane będą odwzorowywane z tego układu CRS w WGS84 (EPSG:4326) przed załadowaniem do aplikacji.

W przypadku ustawienia Auto używany jest układ EPSG:4326 (WGS84).

GEOFILE

Ładuje różne rodzaje formatów plików geograficznych, takich jak GeoJSON i ESRI Shapefile.

W tym przykładzie ładuje się plik GeoJson za pomocą operacji 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"');
Parametry dotyczące GEOFILE
Parametr Typ Użycie Opis
url ciąg znaków domyślnie: brak.

Adres URL pliku zawierającego dane. Dozwolone są tylko adresy URL z protokołami HTTPS lub LIB.

Możesz używać plików ze źródeł danych w przestrzeni aplikacji, używając następującej składni: lib://DataFiles/<nazwa pliku>. Na przykład lib://DataFiles/SalesGeographies.geojson. Możesz również określić miejsce do przechowywania plików, używając następującej składni: lib://<nazwa przestrzeni>:DataFiles/<nazwa pliku>. Na przykład lib://EuropeSales:DataFiles/SalesGeographies.geojson. Możesz również określić plik z Łącznika do dostawcy magazynowania w sieci Web, używając następującej składni: lib://<dostawca magazynowania w sieci Web>/<file name>. Na przykład: lib://Dropbox/SalesGeographies.geojson.

keyField ciąg znaków domyślnie: brak. Nazwa pola zawierającego tożsamości każdej geometrii. Jeśli pozostawisz to pole puste, zostanie wygenerowane pole kluczowe.
type ciąg znaków domyślnie: Auto Typ pliku. Dozwolone wartości to:
  • Auto — próbuje wykryć typ pliku na podstawie nazwy pliku.
  • GeoJSON — format GeoJSON określony przez geojson.org.
  • GML — do odczytywania plików GML lub łączenia się z usługami WFS. Czyta pliki featureCollection i tworzy jeden wiersz każdego elementu featureMember. GeoOperations obsługuje tylko GML2.
  • Shape — plik zip zawierający co najmniej plik shp i dbf w przypadku formatu pliku shapefile ESRI. Ważne jest, aby plik zip został utworzony z tym samym kodowaniem znaków co zawarte w nim pliki.
  • ESRIJson — JSON zwracany przez ESRI ArcGIS Server (zobacz dokument ESRI dotyczący formatu). Umożliwia to łączenie się z serwerem ArcGIS i importowanie danych z opublikowanych przez niego usług.
  • DXF — do odczytu geometrii z pliku DXF AutoCAD. Obsługiwany jest ograniczony zestaw typów elementów punktów i linii: POINT, TEXT, MTEXT, ARC, CIRCLE, LINE, POLYLINE, LWPOLYLINE, SPLINE, and MLINE
encoding ciąg znaków domyślnie: brak. W przypadku niektórych formatów (np. ESRI Shapefile) kodowanie znaków nie jest zdefiniowane w tym formacie. W ten sposób można dostarczyć te informacje. W przypadku większości formatów ta właściwość jest ignorowana.
expectedGeomType ciąg znaków domyślnie: Auto Jednocześnie ładowany jest tylko jeden typ geometryczny. Jeśli w danych jest wiele typów, użyj tej właściwości, aby ustawić ładowany typ. W przypadku formatów, które nie obsługują różnych typów, ten parametr jest ignorowany.
  • Auto — próbuje automatycznie wykryć typ.
  • Point — szuka punktów w określonym pliku.
  • Line — szuka linii w określonym pliku.
  • Polygon — szuka wielokątów w określonym pliku.
crs ciąg znaków domyślnie: Auto Układ odniesienia współrzędnych (CRS) danych do załadowania. Dane będą odwzorowywane z tego układu CRS w WGS84 (EPSG:4326) przed załadowaniem do aplikacji.

Jeśli zostanie ustawiona wartość Auto lub pusta, program będzie próbował określić układ na podstawie analizy zawartości pliku. Jeśli w pliku nie zostanie znaleziony żaden układ CRS, używany jest EPSG:4326 (WGS84). Należy pamiętać, że ustawienie tego parametru na układ CRS zastępuje informacje w pliku i należy to robić tylko w przypadku plików, w których brakuje takich informacji lub gdy wiadomo, że są one błędne. Pliki z danymi z kilkoma układami CRS nie są obsługiwane.

INTABLE

Tabelę, która jest przekazywana jako dane wejściowe do funkcji Extension, można zadeklarować w celu określenia sposobu jej interpretacji. Jeśli nie zostanie zadeklarowana, pole klucza i pole geometrii można w wielu przypadkach wykryć automatycznie na podstawie zawartości. Zaleca się jednak deklarowanie tabel, aby interpretacja nie zmieniła się po załadowaniu nowych danych.

Jeśli tabela zawiera nazwy zamiast geometrii lub kolumn szerokości i długości geograficznej, należy ją zadeklarować.

Jeśli tabela nie zostanie zadeklarowana, będzie liczona jako pierwsza tabela dla domyślnych zestawów danych w operacjach. Jeśli zostanie zadeklarowana, będzie liczona w kolejności zadeklarowania.

Zwykle używany jest format geometrii Qlik Sense, ale obsługiwany jest również format WKT (Well-known text representation of geometry). Umożliwia to odczytywanie danych geograficznych z bazy danych za pomocą jednego z typowych łączników baz danych i konwersję geometrii na geometrie Sense za pomocą operacji Load. Zwróć uwagę, że kiedy geometrie są odczytywane z bazy danych, należy zastosować funkcję zwracającą kolumnę w formacie WKT. Standardowa funkcja SQL nazywa się ST_AsText(), ale niektóre bazy danych mają swoje własne funkcje.

Jednocześnie można użyć tylko jednego z parametrów określających pole lokalizacji, z wyjątkiem latitudeField i longitudeField, które zawsze powinny być definiowane parami.

W odniesieniu do każdej operacji można określić tylko jedną tabelę wbudowaną. Jeśli chcesz użyć danych w co najmniej dwóch tabelach wbudowanych, możesz użyć polecenia STORE, aby zapisać inne tabele wbudowane jako pliki CSV, a następnie ładować je z plików CSV.

Przykład z polami szerokości i długości geograficznej:

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);
Przykład, w którym dane zawierają nazwane lokalizacje, w związku z czym należy zadeklarować parametr 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});
Parametry dotyczące INTABLE
Parametr Typ Użycie Opis
keyField ciąg znaków opcjonalne Nazwa pola zawierającego unikatowe tożsamości dla każdego wiersza. Jeśli nie zostanie określona, dodana zostanie kolumna kluczowa o nazwie _autoIndex_ z unikatowymi wartościami każdego wiersza.
pointField ciąg znaków opcjonalne Pole zawierające dane punktów w formacie punktów Sense: „[długość geograficzna, szerokość geograficzna]”. Obsługiwane są również dane punktów WKT ("POINT(...)").
lineField ciąg znaków opcjonalne Pole zawierające dane linii w formacie linii Qlik Sense, np. „[[długość geograficzna, szerokość geograficzna],[długość geograficzna, szerokość geograficzna],...]”. Obsługiwane są również dane linii WKT ("LINESTRING(...)" lub "MULTILINESTRING(...)").
polygonField ciąg znaków opcjonalne Pole zawierające dane linii w formacie wielokątów Sense, tj. tablica linii zamkniętych lub tablica tablic linii zamkniętych w przypadku wielokątów złożonych. Obsługiwane są również dane wielokątów WKT ("POLYGON(...)" lub "MULTIPOLYGON(...)").
latitudeField ciąg znaków opcjonalne Pole zawierające wartości szerokości geograficznej.
longitudeField ciąg znaków opcjonalne Pole zawierające wartości długości geograficznej.
namedPointField ciąg znaków opcjonalne Pole zawierające nazwy obiektów geograficznych, które są wyszukiwane w bazie danych lokalizacji. Nazwy będą reprezentowane przez punkty.
namedAreaField ciąg znaków opcjonalne Pole zawierające nazwy obiektów geograficznych, które są wyszukiwane w bazie danych lokalizacji. Nazwy będą reprezentowane przez wielokąty. Nie wszystkie nazwy w bazie danych lokalizacji mają powiązane wielokąty.
crs ciąg znaków domyślnie: Auto Układ CRS (Coordinate Reference System) danych do załadowania. Dane będą odwzorowywane z tego układu CRS w WGS84 (EPSG:4326) przed załadowaniem do aplikacji.

W przypadku ustawienia Auto używany jest układ EPSG:4326 (WGS84).

LOCATIONSERVICE

Punkty i obszary dostępne w usłudze lokalizacji serwera Qlik GeoAnalytics Server. Należy określić typ lub kraj.

Pola w tabelach ładowanych z usługi lokalizacji to:

  • LocationDbId — unikatowy identyfikator dla każdej jednostki.
  • LocationPoint/LocationArea — geometria jednostki.
  • CountryIso2 — dwuliterowy kod kraju.
  • Adm1Code — krajowy kod obszaru administracyjnego pierwszego rzędu.
  • Adm2Code — krajowy kod obszaru administracyjnego drugiego rzędu.
  • LocationDbType — patrz Specyfikacja usługi geometrii (tylko w języku angielskim), aby uzyskać więcej informacji na temat typów.

Ten przykład powoduje ładowanie stanów w USA:

MyAirports: Load * Extension GeoOperations.ScriptEval(' Load() DATASOURCE states LOCATIONSERVICE geometry="AREA", type="STATE", country="us" ');
Parametry dotyczące LOCATIONSERVICE
Parametr Typ Użycie Opis
geometry ciąg znaków domyślnie: Area Wybierz dostęp do punktów lub obszarów.
type ciąg znaków domyślnie: Country Rodzaj danych, które reprezentują nazwy, takie jak kraje, obszary administracyjne, kody pocztowe itp. W typach natywnych w bazie danych lokalizacji można używać następujących uproszczonych nazw typów (bez uwzględniania wielkości liter):
  • CONTINENT — nazwa kontynentu.
  • COUNTRY — nazwa kraju.
  • COUNTRYISO2 — kod ISO 3166-1 alpha-2.
  • COUNTRYISO3 — kod ISO 3166-1 alpha-2.
  • ADMIN1 — podział administracyjny pierwszego rzędu.
  • STATE — alias dla ADMIN1.
  • ADMIN2 — podział administracyjny drugiego rzędu.
  • ADMIN3 — podział administracyjny trzeciego rzędu.
  • ADMIN4 — podział administracyjny czwartego rzędu.
  • POSTALCODE — kod pocztowy.
  • ZIP — alias dla POSTALCODE.
  • CITY — nazwa miasta.
  • AIRPORTIATA — kod IATA lotniska.
  • AIRPORTICAO — kod ICAO lotniska.
Więcej szczegółowych informacji o typach zawiera Specyfikacja usługi geometrii (tylko w języku angielskim).
country ciąg znaków domyślnie: brak. Kod kraju (2 lub 3 litery), aby uzyskać dostęp do kraju. Można określić kilka krajów oddzielonych przecinkiem. Wartość domyślna oznacza brak ograniczenia do kraju.
 

Czy ta strona była pomocna?

Jeżeli natkniesz się na problemy z tą stroną lub jej zawartością — literówkę, brakujący krok lub błąd techniczny — daj nam znać, co możemy poprawić!