First または LOAD (SQL) ステートメントへの SELECT プレフィックスは、データ ソース テーブルから最大レコード数をロードする際に使用します。 First プレフィックスを使用する一般的なユース ケースは、大きなレコードから小さなサブセットのレコードを取得する場合および/またはデータのロード ステップが遅い場合です。定義された「n」数のレコードがロードされ次第、ロード ステップが途中で終了し、スクリプトの残りの実行が通常どおり続行されます。
構文:
First n ( loadstatement | selectstatement )
| 引数 | 説明 |
|---|---|
| n | 読み取り対象の最大レコード件数を示す整数を評価する任意の数式。n は (n) のように括弧で囲む場合があります。 |
| loadstatement | selectstatement | n 引数に続く load statement/select statement は、設定された最大レコード数でロードする必要がある指定されたテーブルを定義します。 |
地域の設定
特に指定のない限り、このトピックの例では次の日付書式を使用しています: MM/DD/YYYY。日付書式は、データ ロード スクリプトの SET DateFormat ステートメントで指定されています。既定の日付書式は、地域の設定やその他の要因により、システムによって異なる場合があります。以下の例の書式は、要件に合わせて変更できます。または、これらの例に一致するようにロード スクリプトの書式を変更できます。詳しくは「アプリとスクリプトの地域設定の変更」を参照してください。
アプリの既定地域設定は、ユーザー プロファイルに基づいています。これらの地域の書式設定は、Qlik Cloud ユーザー インターフェースに表示される言語とは関係ありません。Qlik Cloud は使用しているブラウザと同じ言語で表示されます。
アプリの作成者は、作成するアプリの既定の地域を設定できます。詳細については、「Qlik Cloud Analytics でアプリとスクリプトを作成するための優先地域設定の設定」を参照してください。
| 例 | 結果 |
|---|---|
| FIRST 10 LOAD * from abc.csv; | この例では、Excel ファイルから最初の 10 行を取得します。 |
| FIRST (1) SQL SELECT * from Orders; | この例では、Orders データセットから最初に選択された行を取得します。 |