Load

一意のレコードのみをロードする場合、distinct を述語として使用できます。重複するレコードがある場合は、1 つめのインスタンスがロードされます。

先行する LOAD を使用している場合、distinct はロード先のテーブルにのみ反映されるので、Load ステートメントの先頭に distinct を配置する必要があります。

先行する LOAD

ロードする項目のリスト。項目リストとして * を使用すると、テーブルのすべての項目が指定されます。

項目定義には、リテラル、既存項目への参照、または数式を含める必要があります。

fieldname は、テーブル内の項目名と同じテキストです。項目名にスペースなどが含まれる場合は、ストレート二重引用符または角括弧で囲む必要があります。明示的に表現できない項目名については、次のような表記規則を使用します。

@fieldnumber は、区切り記号付きテーブル ファイルの項目番号を表します。「@」が前に付いた正の整数でなければなりません。常に 1 から項目の数まで、番号が振られています。

@startpos:endpos は、固定長レコードが含まれるファイル内の項目の開始および終了位置を表します。位置はどちらも正の整数でなければなりません。2 つの番号の前に「@」を付け、コロン (:) で区切る必要があります。常に 1 から位置の数までの番号が付けられます。最後の項目で、n は終了位置として使用されます。

• @startpos:endpos の直後に I か U の文字が続く場合は、バイトの読み取りは符号付き (I) バイナリまたは符号なし (U) の整数 (Intel のバイト順) と解釈されます。読み取られる位置の数は、1、2、または 4 です。
• @startpos:endposの直後に文字 R が続く場合は、読み取られるバイトはバイナリの実数 (IEEE 32 ビットまたは 64 ビットの浮動小数点) として解釈されます。読み取られる位置の数は、4 または 8 です。
• @startpos:endpos の直後に文字 B が続く場合は、読み取られるバイトは COMP-3 標準に従った BCD (Binary Coded Decimal) 数として解釈されます。任意のバイト数を指定できます。

expression は、同じテーブルにある 1 つまたは複数の項目に基づいた数値関数または文字列関数です。詳細については、数式の構文を参照してください。

項目に新しい名前を割り当てるには、as を使用します。

from は、データをフォルダーまたは Web ファイル データ接続を使用するファイルからロードする必要がある場合に使用します。

file ::= [ path ] filename

'lib://Table Files/'

パスを省略すると、Qlik Sense は、Directory ステートメントで指定されたディレクトリのファイルを検索します。Directory ステートメントがない場合、Qlik Sense は作業ディレクトリ C:\Users\{user}\Documents\Qlik\Sense\Apps を検索します。

Directory

filename には、標準の DOS ワイルドカード文字 (* および ?) が含まれる場合があります。これにより、指定されたディレクトリ内にあるすべての一致ファイルがロードされます。

この書式指定は、括弧に囲まれた複数の書式指定アイテムのリストで構成されます。

書式指定アイテム

レガシー スクリプティング モード

レガシー スクリプト モードは、次のパス形式にも対応しています。

• 絶対パス

  c:\data\

• Qlik Sense アプリ作業ディレクトリへの相対パス。

  data\

• インターネットまたはイントラネット上の位置を示す URL アドレス (HTTP あるいは FTP)。

  http://www.qlik.com

fieldassource::=(tablename, fieldname)

項目は、事前にロードされた tablename と fieldname の名前です。

この書式指定は、括弧に囲まれた複数の書式指定アイテムのリストで構成されます。

data ::= [ text ]

inline 節を使用してい入力するデータは、二重引用符または角括弧で囲む必要があります。括弧で囲まれたテキストは、ファイルのコンテンツと同じ方法で解釈されます。そのため、テキスト ファイルで新しい行を挿入する場合と同様に、inline 節のテキストについても Enter キーを押します。列の数は最初の行で定義されています。

この書式指定は、括弧に囲まれた複数の書式指定アイテムのリストで構成されます。

table label は、元のテーブルを作成した LOAD または SELECT ステートメントの前に配置されるラベルです。ラベルの最後にはコロン (:) を記述します。

事前にロードされているテーブルからのデータのロード

テーブル ラベル

size ::= number

Number は、生成するレコード数を示す整数です。

Peek 関数を使用して、以前にロードされたテーブルの 1 つの項目値を参照しない限り、項目のリストには、外部データ ソースまたは以前にロードされたテーブルからデータを取得する必要のある数式を記述できません。

分析接続からデータをロードすることができます。サーバーサイド拡張 (SSE) プラグインで定義されている関数を呼び出すか、スクリプトを評価する extension 節を使用する必要があります。

SSE プラグインに単一のテーブルを送ることができます。単一のデータ テーブルが返されます。返す項目名が SSE プラグインで指定されていない場合、項目には Field1, Field2 などの名前が付けられます。

Extension pluginname.functionname( tabledescription );

• SSE プラグインの関数を使用したデータのロード

  tabledescription ::= (table { ,tablefield} )

  テーブルの項目を記述していない場合、項目はロードの順で使用されます。

• SSE プラグイン内のスクリプト評価によるデータのロード

  tabledescription ::= ( script, table { ,tablefield} )

テーブル項目定義におけるデータ型の扱い

データ型は、分析接続で自動的に検出されます。データに数値が含まれず、少なくとも 1 個の非 NULL テキスト文字列が含まれる場合、その項目はテキストとみなされます。それ以外の場合は数値とみなされます。

String() または Mixed() で項目名を囲むと、データ型を強制的に指定できます。

• String() は、項目をテキストに指定します。項目が数値の場合、デュアル値のテキスト部分が抽出され、変換は実行されません。
• Mixed() は、項目をデュアルに指定します。

extensionテーブル項目定義以外では、String() または Mixed() は使用できず、テーブル項目定義では他の Qlik Sense 関数を使用できません。

分析接続に関する詳細

分析接続は、使用する前に設定が必要です。

Qlik Sense Enterprise:分析接続の作成

Qlik Sense Desktop: における分析接続の構成Qlik Sense Desktop

GitHub リポジトリでは分析接続に関する詳細を閲覧できます。qlik-oss/server-side-extension

criterion は論理式です。

while は、レコードを繰り返し読み取るかどうかを示す節です。criterion が True の場合は、同じレコードが読み取られます。通常、while 節には IterNo( ) 関数が含まれていなければなりません。

criterion は論理式です。

データを集計 (グループ化) すべき項目を定義するには、group by 節を使用します。 集計項目は、ロードする数式に挿入しなければなりません。集計項目以外の項目は、ロードした数式に含まれる集計関数の外部で使用できます。

groupbyfieldlist ::= (fieldname { ,fieldname } )