Skip to content

マークアップページの記法 ​

マークアップページのコードの文法と、よく使う組み立て方を説明します。要素ごとの属性は、要素一覧を参照してください。

書き方の規則 ​

コードは、HTML に似たタグで要素を書きます。書けるタグと属性は、要素一覧にあるものだけです。HTML のタグ、CSS、class、style は書けません。

html
<Columns>
  <SqlView id="…" page="…" sql="…">
    <Card title="今月の売上">
      <Text size="2xl" weight="bold">{{ row.sales }}</Text>
    </Card>
  </SqlView>
  <Chart id="…" page="…" chart="…" />
</Columns>
  • タグ名と属性名は、大文字と小文字を区別します
  • すべての要素を閉じます。子を持たない要素は /> で閉じます
  • 属性の値は " で囲みます。値に " を含むときは ' で囲みます
  • 真偽値の属性は、値なしで書くと真になります(<Collapse open>)
  • 本文の < は &lt; と書きます。{{ … }} の中には、< をそのまま書けます
  • 本文の空白と改行は、1 つの空白にまとめて表示されます(空白と改行)
  • Markdown は解釈されません。太字や色は <Span>、箇条書きは <List> で書きます
  • <!-- … --> はコメントです。{{ を文字として書くときは、\{{ と書きます

解釈が曖昧な書き方は、推測で補われず、エラーになります。

空白と改行 ​

文字を表示する要素(<Text>・<Heading> など)の中の空白と改行は、HTML と同じく扱われます。

  • 連続する空白と改行は、1 つの空白にまとめて表示されます。<Text>・<Heading> などでは、中の最初と最後の空白は表示されません
  • <Span>・<If>・<For> などの境目をまたいでも、空白は 1 つにまとめて表示されます
  • 制御要素の前後で改行すると、その改行も空白になります。日本語の文で空白を入れたくないときは、改行せずに続けて書きます
html
<Text>前月より<If condition="{{ row.mom > 0 }}">増加</If><Else>減少</Else>しました</Text>
<!-- 前月より増加しました -->

<Text>
  前月より
  <If condition="{{ row.mom > 0 }}">増加</If>
  <Else>減少</Else>
  しました
</Text>
<!-- 前月より 増加 しました -->
  • 文の中で改行するときは、<Br /> を書きます
  • <Tag> の前後には小さな余白があるので、空白を書かずに並べても、間が空いて表示されます

コードの構造 ​

要素ごとに、どの要素の中に書けるか(親)と、中に何を書けるか(子)が決まっています。要素のリファレンスの「構造」の表で確認できます。

構造上の区分 ​

区分内容
blockページに並べる要素(<Text>・<Card>・<Chart> など)。ページの直下と、子に block を取る要素の中に書く
inline文の中に書く要素(<Span>・<Link> など)。<Text>・<Span> の中に書く
text・expr文字と {{ … }}。<Text>・<Heading> など、文字を表示する要素の中に書く
control出し分けと繰り返し(<If>・<For> など)。子に block・inline・control のいずれかを取る要素の中に書く。条件と繰り返しを参照
―決まった親の中にだけ書く要素(<ListItem>・<Tab> など)

<Card> や <TableCell> の中に文字を書くときは、<Text> で囲みます。

要素の ID ​

<Chart>・<SqlView>・<Heading>・<UploadedImage> など、実行結果・画像・リンクに関連付けられる要素には、id を書きます。id が必要な要素は、属性の表で確認できます。

  • 形式は ObjectId(16 進数 24 文字)で、ページの中で重複しないようにします
    • cdm notebook format で、不足している id が補われます。自分で書くときは、cdm util gen-id などで生成した値を使います
    • 要素をコピーしたときや、同じチャートを 2 か所に置くときは、別の id にします
  • 実行結果と画像は id に関連付けられるため、要素を移動しても保持されます。id を書き換えると、別の要素として扱われます
  • <SqlView> の中の要素には、id を書けません

式 ​

本文や属性の値に、{{ … }} で式を書きます。パラメータの値や SQL の結果を、文字・条件・見た目に使えます。

書ける場所 ​

式の書き方は、書く場所によって 2 通りあります。どちらで書くかは、属性の表の値の欄(「式:単一式」「式:文字+式」)で確認できます。

  • 文字+式:文字の中に、値を文字列に変換して差し込みます(title="{{ r.segment }} の解約")。本文と、title など見出しや説明の属性に書けます
  • 単一式:値全体を 1 つの {{ … }} にします(condition="{{ row.mom < 0 }}")。条件・数値・色など、型が決まった属性に書けます。値の欄が「式(…)」の属性も単一式です

書ける式 ​

  • リテラル:文字列('…' か "…")、数値、true、false、null
  • 演算子:== != < <= > >= in && || ! c ? a : b、数値の + - * /、括弧 ( )
  • 関数:size()・sum()・max()・formatNumber()・formatDate() など(式の関数)

ここにない計算は、SQL で列として用意します。属性の値の式で文字列を書くときは、属性を囲む引用符と別の引用符を使います(condition="{{ row.region == 'East' }}")。

式から参照できる値 ​

書き方内容参照できる場所
param_<パラメータの ID>パラメータの値どこでも
view.<名前>表示の状態(表示の状態)どこでも
env.<名前>閲覧している環境(式の環境変数)どこでも
row・rows[n]・size(rows)<SqlView> の結果の行(行の参照)<SqlView> の中
<For> の as・index の変数繰り返している行やグループと、何回目か<For> の中
<Group> の as の変数グループ化したデータ(行のグループ化)<Group> の中
  • パラメータは、最後に実行したときの値を参照します。入力欄で変えただけの値は、実行するまで反映されません
  • 一度も実行していないパラメータはゼロ値になります(文字は ''、日付は '1970-01-01'、数値は 0、複数の値は [] など)。型は式のパラメータの型にあります

値の書式 ​

列をそのまま差し込む({{ row.ts }})と、列の型に合わせた書式で表示されます。式を通した値(計算の結果、条件で選んだ値など)には、書式が適用されません。書式は formatNumber()・formatDate() で指定します(式の書式)。

式表示(JST の場合)
{{ row.ts }}2026/9/30 12:34:56
{{ row.ok ? row.ts : '' }}2026-09-30T03:34:56Z
{{ formatDate(row.ts, "dayjs", "M/D HH:mm") }}9/30 12:34
  • 書式は閲覧者の言語設定に、タイムスタンプは閲覧者のタイムゾーンに従います
  • ID など、桁区切りが要らない整数は formatNumber(row.id, "d3", "d") で表示します
  • 書式を適用した値は文字列です。条件では、書式を適用する前の値で比較します
  • 配列(複数の値を持つパラメータなど)は、, で区切って表示されます

SQL の実行結果の表示 ​

<SqlView> は、SQL ブロックの実行結果を、中に書いた要素で表示します。

html
<SqlView id="…" page="…" sql="…" hideFrame>
  <Columns>
    <Card title="売上">
      <Text size="2xl" weight="bold">{{ formatNumber(row.sales, "compact") }}</Text>
      <Text size="sm" color="muted">前月比 <Delta value="{{ row.mom }}" format=".1%" /></Text>
    </Card>
    <Card title="注文数">
      <Text size="2xl" weight="bold">{{ row.orders }}</Text>
    </Card>
  </Columns>
</SqlView>
  • 中には、<Chart>・<SqlResult>・<SqlView>・<Parameter>・<UploadedImage> は書けません。<SqlView> の外に書きます
  • 中に <Card> を並べるときは、hideFrame を書いて枠の重なりを避けます
  • <SqlView> はクロスフィルタに参加しません

行の参照 ​

書き方内容
row1 行目(rows[0] と同じ)
rows[n]n 行目(0 から数える)。n は整数のリテラルだけ
size(rows)受け取った行の数
  • 列は row.sales で参照します。名前が ASCII の識別子でない列は row['売上'] で参照します
  • 受け取るのは、結果の先頭から 1,000 行までです。列の合計や最大値は、式の関数の sum()・max() などで求めます。結果が 1,000 行を超えるときは、全体の件数や合計を SQL で列として返します
  • 0 行のときも中は表示されます。<If condition="{{ size(rows) == 0 }}"> でメッセージを表示します
  • 実行結果にない列を参照すると、スキーマエラーになります。スキーマエラーは cdm notebook validate では検出されず、cdm notebook run ではステータスが ERROR になります
  • <ParameterOverride> で上書きしても、中の param_<ID> はページのパラメータの値のままです

列の型 ​

列の型式での型
整数・小数数値
文字列文字列
真偽値真偽値
日付文字列(YYYY-MM-DD)
日時・タイムスタンプ文字列(ISO 8601)
NULLnull
時刻・配列・構造体・JSON など参照できない

条件と繰り返し ​

制御要素(<If>・<ElseIf>・<Else>・<For>・<Group>)は、独自の枠を持ちません。子は、親の中に直接書いたものとして並べられます。たとえば <Columns> の中の <For> は、繰り返した 1 回分が 1 列になります。<Text> の中の <For> は、繰り返した分が文の中に並びます(<Text>担当:<For as="r"><Tag>{{ r.owner }}</Tag></For></Text>)。

出し分け ​

html
<If condition="{{ param_6aed7dd1fdecc9316485458f == 'JP' }}">
  <Text>国内の売上</Text>
</If>
<Else>
  <Text>海外の売上</Text>
</Else>
  • <ElseIf>・<Else> は、<If> か <ElseIf> の直後に書きます。間に空白・改行・コメントがあってもかまいません。最初に真になったものだけが表示されます
  • 非表示の中身でも、クエリは実行され、閲覧者に送信されます。データを見せない目的には使えません
  • 閲覧している環境で出し分けるときは env.<名前> を使います(env.mobile・env.print など)
  • 文字だけを出し分けるときは、式で書けます({{ row.mom > 0 ? '増加' : '減少' }})

繰り返し ​

<For> は、<SqlView> の結果の行ごとに子を繰り返します。<SqlView> の中にだけ書けます。

html
<SqlView id="…" page="…" sql="…">
  <Columns>
    <For as="r" index="i" orderBy="{{ r.sales }}" desc limit="3">
      <Card title="{{ i }}位 {{ r.name }}">
        <Text size="xl" weight="bold">{{ r.sales }}</Text>
      </Card>
    </For>
  </Columns>
</SqlView>
  • 行は as の名前で、何回目か(1 から)は index の名前で参照します
  • where で行を選び、orderBy・desc で並べ替え、limit で回数を絞ります
  • 直後に <Else> を書くと、1 回も繰り返さなかったときに表示されます
  • 条件に合う行があるときだけ表示するには、<For where="{{ … }}" limit="1"> を使います
  • <For> の中に <For> は書けません。グループごとに繰り返すときは、<Group> を使います(行のグループ化)
  • 長い一覧をページネーションで分けるときは、<For> を <Paginator> で囲みます。1,000 行を超えるときは、<ParameterPaginator> を使います
  • 一覧を文字で検索して絞り込むときは、<TextInput> で入力欄を置き、where に search(view.<名前>, [列, …]) を書きます
  • 一覧を入力した数値で絞り込むときは、<NumberInput> で入力欄を置き、where に view.<名前> == null || r.price >= view.<名前> のように書きます。未入力のときは NULL です
  • 数値の範囲で絞り込むときは、<RangeSlider> を置き、where に inRange(列, view.<名前>) を書きます

<List>・<Table>・<Flow> など、項目を並べる要素の中に制御要素を書くときは、制御要素の子に項目(<ListItem>・<TableRow>・<FlowStep> など)を書きます。

行のグループ化 ​

<Group> は、結果の行を by の列の値でグループ化したデータを作り、as の変数に入れます。グループを繰り返すには、<For> の in に配列({{ p.groups }} など)を指定します。地域ごとに見出しを付けた一覧や、店舗 × 月のクロス表などに使います。

html
<SqlView id="…" page="…" sql="…">
  <Group as="p" by="region">
    <Columns>
      <For as="g" in="{{ p.groups }}">
        <Card title="{{ g.row.region }}({{ size(g.rows) }} 店舗)">
          <For as="r" in="{{ g.rows }}"><Text>{{ r.store }}:{{ r.sales }}</Text></For>
        </Card>
      </For>
    </Columns>
  </Group>
</SqlView>

<Group as="p" by="store, month" fill="month"> は、次のデータを作ります。

js
p = {
  rows: [/* すべての行 */],
  // store のグループ
  groups: [
    {
      // グループの最初の行
      row: { store: "A", month: "2025-01", sales: 100 /* , ほかの列 */ },
      rows: [/* A のすべての行 */],
      // その中の month のグループ
      groups: [
        { row: { store: "A", month: "2025-01" /* , … */ }, rows: [/* … */] },
        // fill で作った空のグループ
        { row: { store: "A", month: "2025-02", sales: null /* , … */ }, rows: [] },
        // …
      ],
    },
    // …
  ],
  // fill の列の値の一覧
  axes: {
    month: [
      { row: { month: "2025-01" /* , … */ }, rows: [/* すべての店舗の 2025-01 の行 */] },
      // …
    ],
  },
};
項目内容
rowsグループに含まれるすべての行
groups1 段内側の列で分けたグループ。<Group> の変数では、by の最初の列で分けます。by の最後の列のグループにはありません
rowグループの最初の行。rows[0] と同じです。fill で作った空のグループでは、グループ化した列だけに値があり、ほかの列は NULL です。<Group> の変数そのもの(p)にはありません
axes.<列>fill の列の値ごとに、結果全体から集めたグループ。row(その値の最初の行。ほかの列も読めます)と rows を持ちます。<Group> の変数にだけあります
  • グループは、受け取った行(1,000 行まで)から作ります
  • 同じ値の行は、結果の中で離れていても 1 つのグループになります。NULL も 1 つのグループになります
  • グループは集計されません。row の列は、最初の行の値です。合計は、sum(g.rows, 'sales') で求めます

<For> と組み合わせるときは、次のようになります。

  • in には、{{ <変数>.rows }}・{{ <変数>.groups }}・{{ <変数>.axes.<列> }} の形で配列を指定します。<Group> の変数のほか、グループを繰り返す <For> の変数も使えます。演算や関数は書けません
  • in を書いた <For> は、<For> の中にも書けます。その場合、in には、すぐ外側の <For> の変数({{ g.rows }}・{{ g.groups }})だけを指定できます
  • where・orderBy・index・limit は、in の配列に適用されます

並び順 ​

  • fill のない列のグループは、結果で最初に出た順で並びます。SQL の ORDER BY か、<For> の orderBy で並べ替えます
  • fill の列のグループと axes は、値の昇順に並びます(NULL は最後)。<Group> の fillDesc に列を書くと、降順になります。<For> の where・orderBy・desc・limit は書けません。見出しとセルの列がずれるためです
  • 曜日のように値の順と表示の順が違うときは、番号の列でグループ化し、表示には別の列を使います
  • fill の列と <For> の orderBy では、文字列は閲覧者の言語によらず、日本語の照合順で並びます。数字の部分は数の大きさで比べます(2月 は 10月 より前)。漢字は、読みの順になるとは限りません

クロス表 ​

fill の列は、by の前の列のどのグループの中にも、結果に出たすべての値のグループをそろえます。行のない組み合わせは、空のグループになります。見出しの行は axes で作ります。

html
<SqlView id="…" page="…" sql="…">
  <Group as="p" by="store, month" fill="month">
    <Table>
      <TableRow header>
        <TableCell><Text>店舗</Text></TableCell>
        <For as="m" in="{{ p.axes.month }}">
          <TableCell align="end"><Text>{{ m.row.month }}</Text></TableCell>
        </For>
      </TableRow>
      <For as="s" in="{{ p.groups }}">
        <TableRow>
          <TableCell><Text>{{ s.row.store }}</Text></TableCell>
          <For as="c" in="{{ s.groups }}">
            <TableCell align="end">
              <If condition="{{ size(c.rows) == 0 }}"><Text color="muted">-</Text></If>
              <Else><Text>{{ c.row.sales }}</Text></Else>
            </TableCell>
          </For>
        </TableRow>
      </For>
    </Table>
  </Group>
</SqlView>
  • 空のグループの row は、グループ化した列以外が NULL です。そのため、計算すると実行時エラーになります。例のように、size(c.rows) == 0 で先に分けます
  • 値に応じた濃さでセルを塗るとき(ヒートマップ)は、<TableCell> の backgroundIntensity に、値を表全体の最大値で割った値を書きます。縦持ちの結果なので、表全体の最大値は max(p.rows, 'sales') で求められます(backgroundIntensity="{{ size(c.rows) == 0 ? null : c.row.sales / max(p.rows, 'sales') }}")
  • fill がそろえるのは、結果に出た値だけです。どの行にもない値(データのない月)の列は作られません。必ず出したい値は、SQL で行を作ります
  • fill の列のグループ(空のグループを含む)は、合わせて 10,000 個までです(店舗の数 × 月の数)。超えると、<Group> の中は表示されず、実行時エラーになります。SQL で列の値を減らします

表示の切り替え ​

閲覧者がページで変えられるものは、次の 3 つです。

  • 表示の状態:見た目だけを変えます。SQL は実行しません
  • パラメータ:SQL に渡され、データを変えます
  • クロスフィルタ:チャートの凡例や軸の選択を、ほかのチャートや表に連動させます。SQL は実行しません

目的ごとに使う要素は、次のとおりです。

目的要素変えるもの
表示する内容や見た目を切り替える<Select>・<Switch>・<Tabs>・<Collapse>表示の状態
一覧を文字で検索して絞り込む(1,000 行まで)<TextInput> と式の search()表示の状態
一覧を入力した数値で絞り込む(1,000 行まで)<NumberInput>・<Slider>表示の状態
一覧を数値の範囲で絞り込む(1,000 行まで)<RangeSlider> と式の inRange()表示の状態
一覧をページに分けて表示する(1,000 行まで)<Paginator>表示の状態
文の中のリンクでタブや開閉を切り替える<ViewStateLink>表示の状態
入力欄で値を選んで絞り込む<Parameter>パラメータ
推移や内訳のチャートの上で値を選んで絞り込む<ParameterChart>パラメータ
一覧や文の中のリンクで値を設定する(ドリルダウン、期間のプリセット)<ParameterLink>パラメータ
1,000 行を超える一覧を、ページごとに SQL で取得する<ParameterPaginator>パラメータ
チャート同士で凡例や軸の選択を連動させる<CrossFilter>クロスフィルタ

チャートで選んで絞り込む方法は、パラメータとクロスフィルタの 2 つです。ほかのチャートや表の集計も変えるときは、パラメータを使います。SQL を実行し直さずに、表示中のチャートや表の絞り込みをそろえるだけなら、クロスフィルタを使います。違いは次のとおりです。

  • パラメータ
    • SQL を実行し直します
    • パラメータを参照しているすべての <Chart>・<SqlResult>・<SqlView> と、式の param_<ID> に反映されます
    • 選んだ値は、ページ上部のパラメータフォームにも表示されます
  • クロスフィルタ
    • SQL を実行しません。実行済みの結果の中で、同じキーの <CrossFilter> を書いたチャートと表の表示を絞ります
    • <CrossFilter> を書いていないチャート、<SqlView>、式には反映されません
    • 選んだ状態は閲覧者ごとに独立しており、保存されません

表示の状態 ​

<Select>・<Switch>・<TextInput>・<NumberInput>・<Slider>・<RangeSlider>・<Tabs>・<Collapse> に as で名前を付けると、ページのどこからでも view.<名前> で状態を参照できます。状態は閲覧者ごとに独立しており、保存されません。

html
<Select as="metric" variant="segmented">
  <SelectOption value="sales" title="売上" default />
  <SelectOption value="orders" title="注文数" />
</Select>
<If condition="{{ view.metric == 'orders' }}">
  <Chart id="…" page="…" chart="…" />
</If>
<Else>
  <Chart id="…" page="…" chart="…" />
</Else>
要素view.<名前> の値
<Select>選んでいる <SelectOption> の value
<Switch>オンか(真偽値)
<TextInput>入力した文字
<NumberInput>・<Slider>入力した数値。未入力のときは NULL
<RangeSlider>選んだ範囲。下限を [0]、上限を [1] で読みます。未選択のときは NULL
<Tabs>選んでいる <Tab> の value
<Collapse>開いているか(真偽値)
  • 同じ as を書いた要素は、状態を共有します(<Tabs> を切り替える <Select> など)
  • 状態は、マークアップページごとに持ちます。別のページで同じ名前を付けても、状態は共有されません
  • PDF とスクリーンショットは、既定の状態で表示されます。cdm notebook render page では、--view で状態を指定できます
  • 切り替える中身が 1 か所なら、<Tabs> だけで十分です
  • <For> の中には <Tabs>・<Collapse> を書けます。繰り返しの 1 回ごとに状態を持ち、as は書けません。<Select>・<Switch>・<TextInput>・<NumberInput>・<Slider>・<RangeSlider> は書けません
  • as を書かない場合、<SqlView> の中の要素の状態は、実行し直すたびに既定の状態に戻ります
  • as で名前を付けた状態は、<ViewStateLink>・<ParameterLink> でも設定できます。設定したあとの移動先は、scrollTo に書きます(リンクの移動先)

パラメータと実行 ​

既定では、パラメータの値を変えてもページは実行されません。次の操作をしたときに実行されます。

実行されるのは、値が変わったパラメータを参照している要素です。resetIfChanged や optionsSourceSqlResetIfDependentChanged の設定でリセットされたパラメータを参照している要素も、実行されます。ほかのパラメータに、まだ実行に反映していない変更があるときは、ページ全体が実行されます。

選ばれなかった <If> の分岐の要素も、値が変わったパラメータを参照していれば実行されます。そのため、パラメータが未設定のときにもエラーにならないように SQL を書きます。

一覧やチャートから選んだ値で詳しい表示に切り替えるページ(ドリルダウン)は、<ParameterLink> や <ParameterChart> でパラメータを設定し、その値で <If> を書き分けて作ります。作り方は、<ParameterLink> を参照してください。

クロスフィルタ ​

<Chart>・<SqlResult> の中に <CrossFilter> を書くと、グリッドページと同じく、凡例や軸の選択を連動させられます。<ParameterChart> と <SqlView> の中には書けません。キーごとの同期の内容は、クロスフィルタを参照してください。

大きさと並べ方 ​

  • <Columns> は横、<Rows> は縦、<Grid> は格子に子を並べます。そのほかの要素の中では、子は縦に並びます
  • 幅は親で決まります。<Columns> の子は grow の比で幅を分け、grow="0" の子は中身の幅になります
  • 高さは height="320px" のように px で書きます。指定しない場合は、中身に合わせて決まります(<Chart>・<SqlResult> は 360px)
  • <Columns> の子の高さは、既定では最も高い子にそろいます
  • タブの切り替えや開閉で高さが変わります。高さを固定するときは height を書きます
  • モバイル表示では、<Columns>・<Grid> の子は縦一列に並びます。表示を変えるときは env.mobile で出し分けます

エラーの種類 ​

マークアップページのエラーには、構文エラー・スキーマエラー・実行時エラーの 3 種類があります。

種類内容cdm notebook validatecdm notebook run
構文エラーコードだけで分かる誤り検出されるSQL を実行する前に失敗する
スキーマエラーSQL の実行結果のスキーマ(列の名前と型)に合わないコード検出されないステータスが ERROR になる
実行時エラーSQL の実行結果やパラメータの値を当てはめて描画するときに、値を求められない式検出されないステータスが WARNING になる

構文エラー ​

構文エラーは、コードだけで分かる誤りです。書き方の誤りのほか、値の型や参照先の誤りも含みます。

  • 書き方の誤り:閉じていないタグ、存在しない要素や属性、指定されていない必須の属性、書けない場所にある要素、重複した ID、構文に誤りのある式など
  • 値の型や参照先の誤り:属性に書けない値、型の合わない比較や計算、存在しないパラメータ・ページ・SQL ブロックへの参照など

選ばれなかった分岐や <For> の中も含めて、ページのすべてのコードが検査されます。構文エラーが 1 つでもあると、cdm notebook push・cdm notebook run などは失敗します。

スキーマエラー ​

スキーマエラーは、SQL の実行結果の列の名前や型によって決まる誤りです。実行結果にない列の参照のほか、列の型に合わない比較や計算、配列など参照できない型の列の参照も含みます。

  • 構文エラーと同じく、ページのすべてのコードが検査されます
  • スキーマは SQL を実行するまで確定しないため、cdm notebook validate では検出されません。cdm notebook run では、ステータスが ERROR になります

実行時エラー ​

実行時エラーは、SQL の実行結果やパラメータの値を当てはめて描画するときに、値を求められない式があると発生します。たとえば、次のような式が該当します。

  • null との大小比較(row.x > 0 で、x が NULL の場合)
  • 0 による除算
  • SQL の実行結果が 0 行のときの row の参照(row は 1 行目を表すため)
  • <Group> の fill の列のグループが、上限(10,000 個)を超えるとき
  • SQL の実行結果が 1,000 行を超えるときの sum()・avg()・min()・max()

実行時エラーが発生するかどうかは、データによって異なります。そのため、cdm notebook run では、<SqlView> の中の式の実行時エラーは、ERROR ではなく WARNING になります。

  • 計算されるのは、描画される部分の式だけです。選ばれなかった <If>・<ElseIf>・<Else> の中や、1 回も繰り返さない <For> の中の式は計算されません
    • cdm notebook run で WARNING にならなくても、データの変化によって別の部分が描画されると、その部分の式は実行時エラーになる場合があります
  • 実行時エラーになった式の値は、条件では偽、差し込みでは空、色などの属性では既定値として扱われます
  • NULL になりうる列を比較するときは、先に null かどうかを判定します(row.x != null && row.x > 0)。NULL の代わりの値を決めるときは、coalesce() を使います(coalesce(row.x, 0) > 0)

Codatum CLI AIエージェントのための分析環境