資料集 | Qlik Cloud 說明

CSV

文字檔案含有表格資料，可選擇含有幾何。若不指定幾何，可以指定位置名稱。將會載入所有欄位作為字串。

CSV 的參數
參數	類型	使用	描述
url	字串	預設值：無。	包含資料的檔案 URL。僅允許使用 HTTPS 或 LIB 通訊協定的 URL。您可以使用下列語法從應用程式空間中的資料來源使用檔案：lib://DataFiles/<file name>。例如 lib://DataFiles/Offices.csv。您也可以使用下列語法指定儲存檔案的空間：lib://<space name>:DataFiles/<file name>。例如 lib://EuropeSales:DataFiles/Offices.csv。您也可以使用下列語法從 Web 儲存空間提供者連接器指定檔案：lib://<Web Storage Provider>/<file name>。例如 lib://Dropbox/Offices.csv。
keyField	字串	預設值：無。	包含每個幾何識別的欄位名稱。若您讓欄位空白，就會產生索引鍵欄位。
geometryField	字串	預設值：無。	幾何欄位的名稱 (如有)。作為幾何的替代選項，可以指定具有知名的點或區域的欄，如以下「幾何類型」。若點資料位於兩個欄位中，則以下列格式指定：以逗號分隔的緯度欄位名稱和經度欄位名稱。
geometryType	字串	default:POINT	幾何欄位中的幾何類型。允許的值為：點 - 使用 Qlik Sense 點格式的點幾何："[longitude,latitude]" PointLatLon - 一個欄位具有緯度，一個具有經度線條 - 使用 Qlik Sense 線條格式的線條幾何："[[longitude,latitude],[longitude,latitude],...]" 多邊形 - 多邊形幾何，亦即多邊形情況下的封閉線路陣列或封閉線路陣列的陣列 LocationNamedPoint - 地理點名稱，例如城市 LocationNamedArea - 地理區域名稱，例如國家/地區 WKT - WKT 格式的幾何，支援點、線條字串、多線條字串、多邊形和複多邊形，請參閱知名幾何文字呈現對於已命名的點或區域，會在位置服務中查閱幾何，並新增幾何的欄。會新增國家/地區、類型和行政區域的欄，如同在標準區域和點資料集中。
尾碼	字串	預設值：無。	適用於進階使用者。指定的字串附加至所有 ID。這是一種便利的方式，可向基於伺服器的位置服務 (例如國家代碼或類型) 指定更多資訊。替代選項用來在將表格載入到 Qlik 時附加額外資料。透過下列尾碼，所有項目都特定於瑞典的城市： ,SE:city 請參閱幾何服務規格（僅提供英文版）瞭解更多關於要使用的語法的資訊。
標頭	字串	預設值：無。	欄的名稱以逗號分隔。如為空白，第一列包含標頭。
fieldSeparator	字串	default:TAB	分隔欄位的字元。除了一般字元，也允許使用關鍵字 TAB (定位字元)、NEWLINE (新行字元)、COMMA (逗號) 和 SEMICOLON (分號)。
recordSeparator	字串	default:NEWLINE	分隔行的字元。除了一般字元，也允許使用關鍵字 TAB (定位字元)、NEWLINE (新行字元)、COMMA (逗號) 和 SEMICOLON (分號)。
編碼	字串	default:UTF-8	為檔案設定的字元。允許與 Java 中相同的值。
stringQuotes	字串	預設值：無。	可用於引述字串的字元。將不會剖析引號內部的欄位和記錄分隔符號。將會在匯入的資料中移除引號。除了一般字元，也允許使用關鍵字 QUOTE(") (引號)、DOUBLEQUOTE(") (雙引號) 和 SINGLEQUOTE(') (單引號)。
crs	字串	default:Auto	要載入的資料 CRS (座標參考系統 )。資料將會在載入到應用程式之前，從此 CRS 投影到 WGS84 (EPSG:4326)。若設定為自動，則會使用 EPSG:4326 (WGS84)。

GEOFILE

載入不同種類的地理檔案格式，例如 GeoJSON 和 ESRI Shapefile。

此範例透過簡化操作載入 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/<file name>。例如 lib://DataFiles/SalesGeographies.geojson。您也可以使用下列語法指定儲存檔案的空間：lib://<space name>:DataFiles/<file name>。例如 lib://EuropeSales:DataFiles/SalesGeographies.geojson。您也可以使用下列語法從 Web 儲存空間提供者連接器指定檔案：lib://<Web Storage Provider>/<file name>。例如 lib://Dropbox/SalesGeographies.geojson。
keyField	字串	預設值：無。	包含每個幾何識別的欄位名稱。若您讓欄位空白，就會產生索引鍵欄位。
類型	字串	default:Auto	檔案類型。允許的值為： Auto - 嘗試從檔案名稱偵測檔案類型。 GeoJSON - 透過 geojson.org 指定的 GeoJSON 格式。 GML - 用於讀取 GML 檔案或連線至 WFS 服務。讀取 featureCollection 檔案並為每個 featureMember 元素製作一個列。GeoOperations 僅支援 GML2。 Shape - 具有至少一個 SHP 和 DBF 檔案的 ZIP 檔案，用於 ESRI 形狀檔格式。重要的是，應使用與其中檔案相同的字元編碼來建立 ZIP 檔案。 ESRIJson - ESRI ArcGIS 伺服器傳回的 JSON (請參閱 ESRI 文件格式)。這可以連線至 ArcGIS 並從已發佈的服務匯入資料。 DXF - 用於從 AutoCAD DXF 檔案讀取幾何。支援一組受限制的點和線路項目類型： `POINT, TEXT, MTEXT, ARC, CIRCLE, LINE, POLYLINE, LWPOLYLINE, SPLINE, and MLINE`
編碼	字串	預設值：無。	對於某些格式 (例如 ESRI 形狀檔)，格式中沒有定義字元編碼。這給予了提供此資訊的方式。對於大部分的格式，會忽略此屬性。
expectedGeomType	字串	default:Auto	一次只能載入單一幾何類型。若資料中有多種類型，請使用此屬性以設定要載入哪種類型。對於不支援多種類型的格式，會忽略此參數。 Auto - 嘗試自動偵測類型。 Point - 在指定的檔案中尋找點。 Line - 在指定的檔案中尋找線路。 Polygon - 在指定的檔案中尋找多邊形。
crs	字串	default:Auto	要載入的資料座標參考系統 (CRS)。資料將會在載入到應用程式之前，從此 CRS 投影到 WGS84 (EPSG:4326)。若設定為自動，或者若空白，將會嘗試從檔案剖析。若檔案中找不到 CRS，則會使用 EPSG:4326 (WGS84)。請注意，將此設定為 CRS 會覆寫檔案中的資訊，只能對缺乏這類資訊或已知資訊錯誤的檔案進行。不支援具有含數個 CRS 資料的檔案。

INTABLE

可以宣告作為輸入傳遞至延伸函數的表格，以指定如何解譯。若沒有宣告，在許多情況下，可以根據內容自動偵測索引鍵欄位和幾何欄位。不過，建議宣告表格，讓解譯不會在載入新資料之後變更。

若表格包含名稱，而非幾何或緯度和經度欄，則必須宣告。

若沒有宣告表格，這在操作中將會計數為預設資料集的第一個表格。若已宣告，將會以宣告順序計數。

通常會使用 Qlik Sense 幾何格式，但也支援 WKT 格式 (知名幾何文字呈現)。因此可以使用一般資料庫連接器之一從資料庫讀取地理資料，然後使用載入操作將幾何轉換為 Sense 幾何。請注意，從資料庫讀取幾何時，應套用以 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 點格式的點資料，亦即「[longitude, latitude]」。也支援 WKT 點資料 (「POINT(...)」)。
lineField	字串	選用	欄位包含使用 Qlik Sense 線路格式的線路資料：「[[longitude,latitude],[longitude,latitude],...]」。也支援 WKT 線路資料 (「LINESTRING(...)」或「MULTILINESTRING(...)」)。
polygonField	字串	選用	欄位包含使用 Sense 多邊形格式的線路資料，亦即多邊形情況下的封閉線路陣列或封閉線路陣列的陣列。也支援 WKT 多邊形資料 (「POLYGON(...)」或「MULTIPOLYGON(...)」)。
latitudeField	字串	選用	包含緯度值的欄位。
longitudeField	字串	選用	包含經度值的欄位。
namedPointField	字串	選用	欄位包含在位置資料庫中查閱的地理功能名稱。名稱將使用點來呈現。
namedAreaField	字串	選用	欄位包含在位置資料庫中查閱的地理功能名稱。名稱將使用多邊形來呈現。位置資料庫中的所有名稱不一定有相關的多邊形。
crs	字串	default:Auto	要載入的資料 CRS (座標參考系統 )。資料將會在載入到應用程式之前，從此 CRS 投影到 WGS84 (EPSG:4326)。若設定為自動，則會使用 EPSG:4326 (WGS84)。

LOCATIONSERVICE

可用於 Qlik GeoAnalytics 伺服器位置服務的點和區域。必須指定類型或國家/地區。

從位置服務載入的表格中欄位是：

LocationDbId - 每個項目的唯一 ID。
LocationPoint/LocationArea - 項目的幾何。
CountryIso2 - 兩個字母的國家代碼。
Adm1Code - 一級行政區域的國家特定代碼。
Adm2Code - 二級行政區域的國家特定代碼。
LocationDbType - 請參閱幾何服務規格（僅提供英文版）瞭解更多關於類型的資訊。

此範例載入美國的州：

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

LOCATIONSERVICE 的參數
參數	類型	使用	描述
幾何	字串	default:Area	選擇以存取點或區域。
類型	字串	default: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 - 機場 IATA 代碼。 AIRPORTICAO - 機場 ICAO 代碼。請參閱幾何服務規格（僅提供英文版）瞭解更多關於詳細類型的資訊。
country	字串	預設值：無。	要存取之國家/地區的國家/地區代碼 (2 或 3 個字母)。可以指定數個國家/地區，以逗號分隔。預設值表示不限於一個國家/地區。