# Load

チャート修正の文脈では、 LOAD ステートメントにより、スクリプトで定義されたデータ、または以前にロードされたテーブルからハイパーキューブに追加データをロードします。分析接続からデータをロードすることもできます。

情報メモLOAD ステートメントは、Replace または Add プレフィックスを持つか、リジェクトされます。

構文:

Add | Replace LOAD fieldlist

(

inline data [ format-spec ] |

resident table-label

) | extension pluginname.functionname([script] tabledescription)]

[ where criterion | while criterion ]

[ group by groupbyfieldlist ]

[order by orderbyfieldlist ]

引数：

引数

| 引数 | 説明 |
| --- | --- |
| fieldlist | fieldlist ::= ( \* \| field{, \* \| field } )<br><br>ロードする項目のリスト。項目リストとして \* を使用すると、テーブルのすべての項目が指定されます。<br><br>field ::= ( fieldref \| expression ) [as aliasname ]<br><br>項目定義には、リテラル、既存項目への参照、または数式を含める必要があります。<br><br>fieldref ::= ( fieldname \|@fieldnumber \|@startpos:endpos [ I \| U \| R \| B \| T] )<br><br>fieldname は、テーブル内の項目名と同じテキストです。項目名にスペースなどが含まれる場合は、ストレート二重引用符または角括弧で囲む必要があります。明示的に表現できない項目名については、次のような表記規則を使用します。<br><br>@fieldnumber は、区切り記号付きテーブル ファイルの項目番号を表します。「@」が前に付いた正の整数でなければなりません。常に 1 から項目の数まで、番号が振られています。<br><br>@startpos:endpos は、固定長レコードが含まれるファイル内の項目の開始および終了位置を表します。位置はどちらも正の整数でなければなりません。2 つの番号の前に「@」を付け、コロン (:) で区切る必要があります。常に 1 から位置の数までの番号が付けられます。最後の項目で、n は終了位置として使用されます。<br><br><ul><li><span>@<span>startpos</span>:<span>endpos</span></span> の直後に <span>I</span> か <span>U</span> の文字が続く場合は、バイトの読み取りは符号付き (<span>I</span>) バイナリまたは符号なし (<span>U</span>) の整数 (Intel のバイト順) と解釈されます。読み取られる位置の数は、1、2、または 4 です。 </li><li><span>@<span>startpos</span>:<span>endpos</span></span>の直後に文字 <span>R</span> が続く場合は、読み取られるバイトはバイナリの実数 (IEEE 32 ビットまたは 64 ビットの浮動小数点) として解釈されます。読み取られる位置の数は、4 または 8 です。 </li><li><span>@<span>startpos</span>:<span>endpos</span></span> の直後に文字 <span>B</span> が続く場合は、読み取られるバイトは COMP-3 標準に従った <span>BCD (Binary Coded Decimal)</span> 数として解釈されます。任意のバイト数を指定できます。 </li></ul><br><br>expression は、同じテーブルにある 1 つまたは複数の項目に基づいた数値関数または文字列関数です。詳細については、数式の構文を参照してください。<br><br>項目に新しい名前を割り当てるには、[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)as を使用します。 |
| [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)inline | スクリプト内でデータを入力し、ファイルからロードしない場合は、inline を使用します。<br><br>data ::= [ text ]<br><br>inline 節を使用してい入力するデータは、二重引用符または角括弧で囲む必要があります。括弧で囲まれたテキストは、ファイルのコンテンツと同じ方法で解釈されます。そのため、テキスト ファイルで新しい行を挿入する場合と同様に、inline 節のテキストについても Enter キーを押します。列の数は最初の行で定義されています。<br><br>format-spec ::= ( fspec-item {, fspec-item } )<br><br>この書式指定は、括弧に囲まれた複数の書式指定アイテムのリストで構成されます。詳細については、「[書式指定アイテム](https://help.qlik.com/ja-JP/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/ScriptSpecifiers/format-specification-items.htm)」を参照してください。 |
| [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)resident | 事前にロード済みのテーブルからデータをロードする場合は、resident を使用します。<br><br>table label は、元のテーブルを作成した LOAD ステートメントの前に配置されるラベルです。ラベルの最後にはコロン (:) を記述します。<br><br>[事前にロードされているテーブルからのデータのロード](https://help.qlik.com/ja-JP/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/load-data-from-previously-loaded-table.htm)<br><br>[テーブル ラベル](https://help.qlik.com/ja-JP/sense/May2026/Subsystems/Hub/Content/Sense_Hub/Scripting/table-labels.htm) |
| extension | 分析接続からデータをロードすることができます。サーバーサイド拡張 (SSE) プラグインで定義されている関数を呼び出す、またはスクリプトを評価する extension 節を使用する必要があります。<br><br>SSE プラグインに単一のテーブルを送ることができます。単一のデータ テーブルが返されます。返す項目名が SSE プラグインで指定されていない場合、項目には Field1, Field2 などの名前が付けられます。<br><br>Extension pluginname.functionname( tabledescription );<br><br><ul><li><p>SSE プラグインの関数を使用したデータのロード </p><p><span>tabledescription ::= (table { ,tablefield} )</span></p><p>テーブルの項目を記述していない場合、項目はロードの順で使用されます。</p></li><li><p>SSE プラグイン内のスクリプト評価によるデータのロード</p><p><span>tabledescription ::= ( script, table { ,tablefield} )</span></p></li></ul><br><br>テーブル項目定義におけるデータ型の扱い<br><br>データ型は、分析接続で自動的に検出されます。データに数値が含まれず、少なくとも 1 個の非 NULL テキスト文字列が含まれる場合、その項目はテキストとみなされます。それ以外の場合は数値とみなされます。<br><br>String() または Mixed() で項目名を囲むことで、データ型を強制的に指定できます。<br><br><ul><li><span>String()</span> は項目をテキストに指定します。項目が数値の場合、デュアル値のテキスト部分が抽出され、変換は実行されません。</li><li><span>Mixed()</span> は項目をデュアルに指定します。</li></ul><br><br>拡張テーブル項目定義以外では、String()、Mixed() は使用できず、テーブル項目定義では他の Qlik Sense 関数を使用できません。<br><br>GitHub リポジトリでは分析接続に関する詳細を閲覧できます。[qlik-oss/server-side-extension](https://github.com/qlik-oss/server-side-extension) |
| [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)where | where 節は、レコードを選択に含めるかどうかを示します。criterion が True の場合は選択が含まれます。<br><br>criterion は論理式です。 |
| [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)while | while は、レコードを繰り返し読み取るかどうかを示す節です。criterion が True の場合は、同じレコードが読み取られます。通常、while 節には IterNo( ) 関数が含まれていなければなりません。<br><br>criterion は論理式です。 |
| [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)group by | データを集計 (グループ化) すべき項目を定義するには、group by 節を使用します。 集計項目は、ロードする数式に何らかの方法で含めてください。集計項目以外の項目は、ロードした数式に含まれる集計関数の外部で使用できます。<br><br>groupbyfieldlist ::= (fieldname { ,fieldname } ) |
| [](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)[](https://help.qlik.com/en-US/sense/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/RegularStatements/Load.htm)order by | order by 節は、load ステートメントで処理される前に、常駐テーブルのレコードをソートします。1 つ以上の項目の昇順または降順で、常駐テーブルをソートできます。最初に数値、次に各国の照合順でソートされます。この節は、データ ソースが常駐テーブルの場合に限り使用できます。<br><br>順序項目は、常駐テーブルをソートする項目を指定します。項目は、名前または常駐テーブル内での番号 (最初の項目が番号 1) で指定できます。<br><br>orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] }<br><br>sortorder は、昇順の asc または降順の desc のどちらかになります。sortorder を指定しない場合は、asc と見なされます。<br><br>fieldname、path、filename、aliasname は、それぞれの名前を示すテキスト文字列です。ソース テーブルのフィールドは fieldname として使用できます。ただし、as 節 (aliasname) を使用して作成された項目は範囲外になり、同じ load ステートメント内では使用できません。 |

## 詳細を見る

* [Add](https://help.qlik.com/ja-JP/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/Prefixes/Add.htm)
* [Replace](https://help.qlik.com/ja-JP/sense/May2026/Subsystems/Hub/Content/Sense_Hub/ChartLevelScripting/Prefixes/Replace.htm)