# Load LOAD ステートメントは、ファイル、スクリプトで定義されたデータ、事前にロードされたテーブル、Web ページ、後続の SELECT ステートメントの結果、または自動生成されたデータから項目をロードします。 構文: LOAD [ distinct ] fieldlist [( from file [ format-spec ] | from\_field fieldassource [format-spec] inline data [ format-spec ] | *resident* table-label | autogenerate size )] [ where criterion | while criterion ] [ group\_by groupbyfieldlist ] [order\_by orderbyfieldlist ] 引数： 引数をロードする | 引数 | 説明 | | --- | --- | | distinct [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) | 一意のレコードをロードする場合にのみ、distinct を述語として使用できます。重複したレコードがある場合、最初のインスタンスがロードされます。

先行する Load を使用している場合、distinct はロード先テーブルにのみ影響するため、最初の Load ステートメントに distinct を配置する必要があります。 | | fieldlist | fieldlist ::= ( \* \| field {, field } )

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

field ::= ( fieldref \| expression ) [as aliasname ]

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

fieldref ::= ( fieldname \|@fieldnumber \|@startpos:endpos [ I \| U \| R \| B \| T] )

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

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

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



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

項目に新しい名前を割り当てるには、[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)as を使用します。 | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)from | from は、データをファイルからロードする必要がある場合に使用します。

file ::= [ path ] filename



パスを省略すると、QlikView は、Directory ステートメントで指定されたディレクトリのファイルを検索します。Directory ステートメントが存在しない場合は、QlikView は作業中のディレクトリを検索します。通常は、このディレクトリは QlikView ファイルが置かれているディレクトリです。

情報メモQlikView サーバー インストール時のデフォルトの作業ディレクトリは、C:\ProgramData\QlikTech\Documents になります。デフォルトの作業ディレクトリは QlikView 管理コンソール で変更できます。

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

format-spec ::= ( fspec-item { , fspec-item } )

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

[Directory](https://help.qlik.com/ja-JP/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Directory.htm)

[From](https://help.qlik.com/ja-JP/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/From.htm) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)from\_field | from\_field 事前にロードされた項目からデータをロードする場合は、 を使用します。

fieldassource::=(tablename, fieldname)

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

format-spec ::= ( fspec-item {, fspec-item } )

この書式指定は、括弧に囲まれた複数の書式指定アイテムのリストで構成されます。 | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)inline | inline スクリプト内でデータを入力し、ファイルからロードしない場合は、 を使用します。

data ::= [ text ]

inline 句を通じて入力されるデータは、角括弧、引用符、またはバックティックなどの特定の文字で囲む必要があります。括弧で囲まれたテキストは、ファイルのコンテンツと同じ方法で解釈されます。そのため、テキスト ファイル内で新しい行を挿入する場合は、inline 句のテキスト内でも新しい行を挿入する必要があります。つまり、スクリプトを入力するときに Enter キーを押します。

単純なインライン ロードでは、列の数は最初の行で定義されます。

format-spec ::= ( fspec-item {, fspec-item } )

インライン ロードは、他のロード テーブルにある同じ形式仕様項目の多くでカスタマイズすることができます。これらの項目は括弧で囲まれています。詳細については、「[書式指定アイテム](https://help.qlik.com/ja-JP/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptSpecifiers/format-specification-items.htm)」を参照してください。

インライン ロードの詳細については、「[インライン テーブルからデータを読み込む](https://help.qlik.com/ja-JP/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/Scripting/inline-loads-qv.htm)」を参照してください。 | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)resident | 事前にロード済みのテーブルからデータをロードする場合は、resident を使用します。

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

QlikView 12.00 以降で distinct と resident Load ステートメントを組み合わせて使用する場合、データのロード順は QlikView 11.20 とは異なります。適切なロード順を定義するには、order by 節を追加します。

[事前にロードされているテーブルからのデータのロード](https://help.qlik.com/ja-JP/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/Scripting/load-data-from-previously-loaded-table.htm)

[テーブル ラベル](https://help.qlik.com/ja-JP/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/Scripting/table-labels.htm) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)autogenerate | QlikView でデータを自動生成する場合は、autogenerate を使用します。

size ::= number

Number は、生成するレコード数を示す整数です。項目のリストには、データベースからデータを取得する必要のある数式を記述できません。数式では、定数とパラメータを使用しない関数 (rand() や recno() など) のみが使用されます。 | | extension | 分析接続からデータをロードすることができます。extension 節を使用して、サーバーサイド拡張 (SSE) プラグインで定義された関数を呼び出すか、スクリプトを評価する必要があります。

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

Extension pluginname.functionname( tabledescription );



テーブル項目定義でのデータ型の処理

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

項目名を String() または Mixed() でラップすることによって、データ型を強制できます。



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

分析接続に関する詳細

QlikView Server または QlikView Desktop での分析接続の作成については、以下を参照してください: [分析接続](https://help.qlik.com/ja-JP/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/Analytic_connections.htm)

GitHub リポジトリでは分析接続に関する詳細を閲覧できます。[qlik-oss/server-side-extension](https://github.com/qlik-oss/server-side-extension) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)where | where 節は、レコードを選択に含めるかどうかを示します。criterion が True の場合は選択が含まれます。

criterion は論理式です。 | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)while | while は、レコードを繰り返し読み取るかどうかを示す節です。criterion が True である限り、同じレコードが読み取られます。通常、while 節には IterNo( ) 関数が含まれていなければなりません。

criterion は論理式です。 | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)group\_by | データを集計 (グループ化) すべき項目を定義するには、group by 節を使用します。 集計項目は、ロードする数式に挿入しなければなりません。集計項目以外の項目は、ロードした数式に含まれる集計関数の外部で使用できます。

groupbyfieldlist ::= (fieldname { ,fieldname } ) | | [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)[](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm)order\_by | order by 節は、load ステートメントで処理される前に、常駐テーブルのレコードをソートします。1 つ以上の項目の昇順または降順で、常駐テーブルをソートできます。最初に数値、次に各国の照合順でソートされます。この節は、データ ソースが常駐テーブルの場合に限り使用できます。

順序項目は、常駐テーブルをソートする項目を指定します。項目は、名前または常駐テーブル内での番号 (最初の項目が番号 1) で指定できます。

orderbyfieldlist ::= fieldname [ sortorder ] { , fieldname [ sortorder ] }

sortorder は、昇順の asc または降順の desc のどちらかになります。sortorder を指定しない場合は、asc と見なされます。

fieldname、path、filename、aliasname は、それぞれの名前を示すテキスト文字列です。ソース テーブルのフィールドは fieldname として使用できます。ただし、as 節 (aliasname) を使用して作成された項目は範囲外になり、同じ load ステートメント内では使用できません。 | from、inline、resident、from\_field、または autogenerate 節でデータのソースが指定されない場合、データは直後の SELECT または LOAD ステートメントの結果からロードされます。後続のステートメントには、プレフィックスを記述できません。 [先行する LOAD](https://help.qlik.com/ja-JP/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/Scripting/preceding-load.htm) [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### さまざまなファイル形式のロード 区切り記号付きデータ ファイルを既定のオプションでロードします。 `LOAD * from data1.csv; ` ` ` コンマを区切り記号として指定し、埋め込みラベル付きで、区切り記号付きファイルをロードします。 `LOAD * from 'c:\userfiles\data1.csv' (ansi, txt, delimiter is ',', embedded labels); ` ` ` タブを区切り記号として指定し、埋め込みラベル付きで、区切り記号付きファイルをロードします。 `LOAD * from 'c:\userfiles\data2.txt' (ansi, txt, delimiter is '\t', embedded labels);` ` ` dif ファイルを埋め込みヘッダー付きでロードします。 `LOAD * from file2.dif (ansi, dif, embedded labels);` ` ` 固定長レコード ファイルから、ヘッダーなしで 3 項目をロードします。 `LOAD @1:2 as ID, @3:25 as Name, @57:80 as City from data4.fix (ansi, fix, no labels, header is 0, record is 80); ` ` ` QVX ファイルを、絶対パスを指定してロードします。 `LOAD * from C:\qdssamples\xyz.qvx (qvx);` ` ` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### 特定の項目の選択、項目名の変更および項目の計算 区切り記号付きファイルから特定の 3 項目のみロードします。 `LOAD FirstName, LastName, Number from data1.csv; ` ` ` ラベルなしでファイルをロードする場合、最初の項目の名前を A に変更し、2 番目の項目の名前を B に変更します。 `LOAD @1 as A, @2 as B from data3.txt (ansi, txt, delimiter is '\t', no labels); ` ` ` Name を、FirstName、空白文字、および LastName の連結としてロードします。 `LOAD FirstName&' '&LastName as Name from data1.csv; ` ` ` Quantity、Price、および Value (Quantity と Price の積) をロードします。 `LOAD Quantity, Price, Quantity*Price as Value from data1.csv;` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### 特定のレコードの選択 一意のレコードのみロードします。重複しているレコードは破棄されます。 `LOAD distinct FirstName, LastName, Number from data1.csv; ` ` ` 項目 Litres がゼロ (0) より大きい値を持つレコードのみロードします。 `LOAD * from Consumption.csv where Litres>0; ` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### ファイル上にないデータおよび自動生成されたデータのロード CatID および Category という 2 項目のインライン データを持つテーブルをロードします。 ` LOAD * Inline ` ` [CatID, Category ` ` 0,Regular ` ` 1,Occasional ` ` 2,Permanent]; ` ` ` UserID、Password、および Access という 3 項目のインライン データを持つテーブルをロードします。 ` LOAD * Inline [UserID, Password, Access ` ` A, ABC456, User ` ` B, VIP789, Admin]; ` ` ` 10 000 行を持つテーブルをロードします。項目 A には、読み取られたレコード (1,2,3,4,5...) の数が含まれ、項目 B には 0 ～ 1 間の乱数が含まれます。 `LOAD RecNo( ) as A, rand( ) as B autogenerate(10000);` 情報メモautogenerate 後の丸かっこはオプションです。 [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### 事前にロードされているテーブルからのデータのロード 最初に、区切り記号付きテーブル ファイルをロードし、tab1 という名前を付けます。 ` tab1: ` `SELECT A,B,C,D from transtable; ` ` ` ロード済みのテーブル tab1 から tab2 として項目をロードします。 `tab2:` `LOAD A,B,month(C),A*B+D as E resident tab1;` ` ` ロード済みのテーブル tab1 から項目 (ただし、A が B より大きいレコードのみ) をロードします。 `tab3:` `LOAD A,A+B+C resident tab1 where A>B;` ` ` ロード済みのテーブル tab1 から、A によって指定された項目をロードします。 `LOAD A,B*C as E resident tab1 order by A;` ` ` ロード済みのテーブル tab1 から、最初の項目によって指定された項目をロードし、次に 2 番目の項目によって指定された項目をロードします。 `LOAD A,B*C as E resident tab1 order by 1,2;` ` ` ロード済みのテーブル tab1 から、C によって指定された項目を降順でロードし、次に B によって指定された項目を昇順でロードし、最初の項目を降順でロードします。 `LOAD A,B*C as E resident tab1 order by C desc, B asc, 1 des;` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### 事前にロードされている項目からのデータのロード 事前にロードされているテーブル Characters から、項目 Types を A としてロードします。: `LOAD A from_field (Characters, Types);` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### 後続のテーブルからのデータのロード (先行する Load) 後続の SELECT ステートメントにロードされている Table1 から、A、B、および計算項目の X および Y をロードします。 ` LOAD A, B, if(C>0,'positive','negative') as X, weekday(D) as Y; ` `SELECT A,B,C,D from Table1;` ` ` [先行する LOAD](https://help.qlik.com/ja-JP/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/Scripting/preceding-load.htm) [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### データのグループ化 ArtNo によってグループ化 (集計) された項目をロードします。 `LOAD ArtNo, round(Sum(TransAmount),0.05) as ArtNoTotal from table.csv group by ArtNo; ` ` ` Week と ArtNo によってグループ化 (集計) された項目をロードします。 `LOAD Week, ArtNo, round(Avg(TransAmount),0.05) as WeekArtNoAverages from table.csv group by Week, ArtNo;` ` ` [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### 1 つのレコードの反復読み取り この例では、ひとつの項目に各生徒の成績が要約して含まれている、入力ファイル Grades.csv があります。 `Student,Grades` `Mike,5234` `John,3345` `Pete,1234` `Paul,3352` 成績は、1 から 5 に分かれていて、科目 Math、English、Science、および History を表しています。IterNo( ) 関数をカウンタとして使用して、各レコードを複数回、while 節で読み取り、成績を個々の値に分けることができます。読み取るたびに、Mid 関数で成績が抽出され、Grade に保存され、科目が pick 関数を使用して選択され、Subject に保存されます。最後の while 節には、全成績が読み取られたか確認するテスト (この場合、生徒 1 人に付き 4 教科分) が含まれています。その後、次の生徒の成績を読み取ります。 ` MyTab: ` ` LOAD Student, ` ` mid(Grades,IterNo( ),1) as Grade, ` ` pick(IterNo( ), 'Math', 'English', 'Science', 'History') as Subject from Grades.csv ` `while IsNum(mid(Grades,IterNo(),1));` ` ` 結果は、このデータが含まれるテーブルにあります。 ![A table containing data for Students, Subjects, and Grades.](https://help.qlik.com/ja-JP/qlikview/September2025/Subsystems/Client/Content/Resources/Images/ex_gen_LoadRepeated.png) [](https://help.qlik.com/en-US/qlikview/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptRegularStatements/Load.htm) #### 分析接続からロードする 次のサンプル データが使用されます。 ``` Values: Load Rand() as A, Rand() as B, Rand() as C AutoGenerate(50); ``` 関数を使用してデータをロードする 以下の例では、P という名前の分析接続プラグインがあり、カスタム関数 Calculate(Parameter1, Parameter2) を含むことを前提とします。この関数は、項目 Field1 および Field2 を含むテーブル Results を返します。 ``` Load * Extension P.Calculate( Values{A, C} ); ``` 項目 A および C を関数に送信すると返されるすべての項目をロードします。 ``` Load Field1 Extension P.Calculate( Values{A, C} ); ``` 項目 A および C を関数に送信すると、Field1 項目のみをロードします。 ``` Load * Extension P.Calculate( Values ); ``` 項目 A および B を関数に送信すると返されるすべての項目をロードします。項目が指定されていない場合は、テーブルの順序の最初の A および B が使用されます。 ``` Load * Extension P.Calculate( Values {C, C}); ``` 項目 C を関数の両方のパラメータに送信すると返されるすべての項目をロードします。 Load \* Extension P.Calculate( Values {String(A), Mixed(B)}); 文字列として強制された項目 A および数値として強制された B を関数に送信するときに、返されるすべての項目をロードします。 スクリプトの評価によってデータをロードする Load A as A\_echo, B as B\_echo Extension R.ScriptEval( 'q;', Values{A, B} ); A および B の値を送信すると、スクリプト q によって返されるテーブルをロードします。 Load \* Extension R.ScriptEval( '$(My\_R\_Script)', Values{A, B} ); A および B の値を送信すると、My\_R\_Script 変数に格納されたスクリプトによって返されるテーブルをロードします。 Load \* Extension R.ScriptEval( '$(My\_R\_Script)', Values{B as D, \*} ); 名前が D、A、および C に変更された B の値を送信すると、My\_R\_Script 変数に格納されたスクリプトによって返される値をロードします。\* を使用すると、残っている照会先のない項目が送信されます。 ## 詳細を見る * [書式指定アイテム](https://help.qlik.com/ja-JP/qlikview/September2025/Subsystems/Client/Content/QV_QlikView/Scripting/ScriptSpecifiers/format-specification-items.htm)