【SAP基礎】ADTのSQLコンソールでテーブルを照会する方法

テーブルの中身を確かめるとき、SE16N では 2 つのテーブルを結合したり、件数を集計したりするのに手間がかかります。

Eclipse に ABAP Development Tools(ADT)を入れると、データプレビュー でテーブルの中身を表示でき、SQL コンソール で SELECT 文をそのまま流せます。レポートを作らずに、結合や集計の結果をすぐに見られます。

この記事では、次の操作を画面を 1 つずつ追って解説します。

• データプレビューで テーブルの中身を表示し、絞り込む手順
• SQL コンソールで SELECT 文を流し、結合・集計する手順

データプレビューと SQL コンソールの概要

データプレビューと SQL コンソールとは

データプレビュー(Data Preview)は、テーブルやビュー、CDS ビューの中身を表として表示する機能です。

画面で列や条件を選ぶと、裏で ABAP SQL の SELECT 文が組み立てられて実行されます。

既定では、先頭の 100 件が表示されます。表示する件数の上限は「Max. Rows」で変えられ、100,000 件まで指定できます。

SQL コンソール(SQL Console)は、ABAP SQL の SELECT 文を自分で書いて実行する画面です。

書けるのは新しい ABAP SQL の構文だけです。列はカンマで区切り、テーブルの別名と列は ~ でつなぎます(例: c~bukrs)。

実務の例

経理部などから、会社コードごとの国名の一覧や、伝票タイプごとの伝票の件数を、すぐに知りたいと頼まれることがあります。

テーブルの中身は、データプレビューで確かめます。テーブルの結合や、伝票タイプごとの件数集計は SQL コンソールで行います。

この記事の操作との対応は、次のとおりです。

したいこと	使う操作
会社コードの設定を見る	データプレビューでテーブルを見る
国名を日本語で並べる(2 つのテーブルを結合する)	SQL コンソールで SELECT 文を流す
伝票タイプごとの件数を数える(集計する)	SQL コンソールで SELECT 文を流す
データを直す	この記事では扱いません。データプレビューと SQL コンソールは、テーブルの中身を見るための道具です

データプレビューと SQL コンソールの使い分け

データプレビューで画面から条件を選ぶと SELECT 文が組み立てられ、SQL コンソールでは SELECT 文を直接書いて結果を見る、という関係です。

2 つの画面の違いは、次のとおりです。

	データプレビュー	SQL コンソール
開き方	テーブルを開いて Run As → ABAP Application	プロジェクトの右クリック → SQL Console、またはデータプレビューの「SQL Console」
条件の指定	「Add Filter」で列と値を選ぶ	WHERE 句を書く
結合・項目別集計	できません	INNER JOIN・GROUP BY・COUNT などを書けます
件数の上限	「Max. Rows」(既定 100)	「Max. Rows」(既定 100)

データプレビューでテーブルを見る

使うデータ

経理部から「会社コードごとの国名の一覧と、会社コード 1010 の今年度の伝票が伝票タイプごとに何件あるかを、すぐに知りたい」と頼まれた場面を考えます。

この記事では、この依頼を例に操作します。使うデータは次のとおりです。

データ	この例の値	使うところ
会社コードのテーブル	T001	データプレビューで開き、SQL コンソールでも照会します
国名のテーブル	T005T(言語 J の行)	T001 と INNER JOIN でつなぎ、日本語の国名を出します
会計伝票ヘッダのテーブル	BKPF	伝票タイプ(BLART)ごとの件数を GROUP BY で数えます
会社コード	1010(結合の例では 1010・1710・JZ01)	データプレビューの絞り込みと、SELECT 文の WHERE 句に入れます
会計年度	2026	BKPF の件数を数える WHERE 句に入れます

上記の値は、この記事で使った検証環境のものです。ご自分の環境では、会社コードと会計年度を、それぞれの値に読み替えてください。テーブル名は読み替えずに、そのまま使います。

前提条件として、Eclipse に ABAP Development Tools(ADT)を入れ、SAP のシステムにつないだ ABAP プロジェクトが必要です。

あわせて、ADT を使うためのロール(SAP の標準ロールでは SAP_BC_DWB_ABAPDEVELOPER など)と、見るテーブルの表示権限も必要です。

Eclipse と ADT の入れ方、ABAP プロジェクトの作り方は、次の記事の「Eclipse を準備する」で解説しています。

1. テーブルを開く

Project Explorer で ABAP プロジェクトを選びます。

メニューの「Navigate」→「Open ABAP Development Object…」を選びます。Ctrl+Shift+A キーでも開けます。

「Open ABAP Development Object」のダイアログが表示されます。

この例では、T001 と入れ、「T001 (Database Table)」を選んで③「OK」を押します。T001 の定義がエディタに表示されます。

2. データプレビューを開く

T001 の定義を開いたまま、メニューの「Run」→「Run As」→「1 ABAP Application」を選びます(F8 キーでも開けます)。

3. 結果の画面を見る

「Data Preview」のタブに、T001 の中身が表として表示されます。

4. 条件で絞り込む

①「Add Filter」を押して、絞り込む列を選びます。この例では BUKRS(会社コード)を選びます。

右に「Filters」が表示されるので、値の欄に 1010 と入れて Enter キーを押します。

5. 件数を数える

「Number of Entries」を押すと、「Number of Entries」のダイアログに、条件に合う件数が表示されます。

「Number of Entries」は、「Max. Rows」に関係なく、条件に合う件数をすべて数えます。件数の多いテーブルで、表示しきれない件数を確かめるときに使います。

6. 裏で実行した SQL 文を見る

「Show Log」を押すと、「Data Explorer Log」が表示されます。データプレビューが組み立てて実行した SQL 文が、新しいものほど下に並びます。

7. 結果をファイルに保存する

結果の表の右上にある保存のアイコンの ▼ を押すと、保存する形式を選べます。

SQL コンソールで SELECT 文を流す

1. SQL コンソールを開く

Project Explorer で ABAP プロジェクトを右クリックし、「SQL Console」を選びます。

データプレビューの「SQL Console」から開くと、データプレビューで絞り込んだ条件の SELECT 文が入った状態で開きます。

データプレビューで形を作ってから、SQL コンソールで書き足すと楽です。

2. SELECT 文を流す

SQL の欄の中身を消して、次の文を入れます。

SELECT bukrs, butxt, land1, waers, ktopl FROM t001 WHERE bukrs = '1010'

「Run」を押します。

3. 2 つのテーブルを結合する

T001 の LAND1 には国のキーが入っています。日本語の国名は、テーブル T005T の該当する言語の行から取ります。

次の文で、2 つのテーブルを INNER JOIN でつなぎ、日本語の国名を並べます。

SELECT c~bukrs, c~butxt, c~land1, t~landx
  FROM t001 AS c
  INNER JOIN t005t AS t ON t~land1 = c~land1 AND t~spras = 'J'
  WHERE c~bukrs IN ('1010','1710','JZ01')

4. 件数を集計する

次の文で、会社コード 1010 の 2026 年度の会計伝票を、伝票タイプ(BLART)ごとに数えます。

SELECT blart, COUNT(*) AS cnt FROM bkpf
  WHERE bukrs = '1010' AND gjahr = '2026'
  GROUP BY blart ORDER BY cnt DESCENDING

5. 取り出す件数を決める

「Max. Rows」を 5 にして、もう一度「Run」を押します。

SQL 文の中の件数の指定ではなく、「Max. Rows」で取り出す件数の上限を指定します。SQL 文の中に件数を書いても、「Max. Rows」の値が使われます。

全体の件数を知りたいときは、結果の上の「Number of Entries」を押します。この例では 22 件と表示されます。

6. 前に流した文を呼び出す

「Run」の右の ▼ を押すと、これまでに流した SELECT 文が新しい順に並びます。

よくあるつまずき

「The elements in the “SELECT LIST” list must be separated using commas.」と出る

列をカンマで区切っていません。SQL コンソールでは、新しい ABAP SQL の構文だけが使えます。
SELECT bukrs butxt ではなく SELECT bukrs, butxt と書くのが正です。

「Incorrect nesting: For the statement “CATCH”, there is no open structure introduced by “TRY”.」と出る

この例の集計文では、GROUP BY に書いた列 blart が SELECT の列に入っていないと、このエラーになります。
GROUP BY の列を、SELECT の列にも入れると通ります。

この例の 2 つの文の結果は、次のとおりです。

SELECT 文	結果
SELECT COUNT(*) AS cnt … GROUP BY blart	このエラーになる
SELECT blart, COUNT(*) AS cnt … GROUP BY blart	通る

エラーの文は SELECT 文と関係なく見えるので、GROUP BY を使った文でこのエラーが出たら、まず SELECT の列を確かめるとよいでしょう。

そのほか

• 2 つの列を比べる条件がエラーになる: 別名を付けずに WHERE bwkey <> werks のように列どうしを比べると、右の列が ABAP の変数とみなされてエラーになります。
  FROM t001w AS x WHERE x~bwkey <> x~werks のように、別名を付けて ~ でつなぎます。
• 件数が 100 件で止まる: 「Max. Rows」の既定は 100 件です。
  全体の件数は「Number of Entries」で確かめ、表示したい件数に合わせて「Max. Rows」を変えます。
• CDS ビューの件数が思ったより少ない: CDS ビューにアクセス制御が付いていると、ユーザの権限で行が絞られ、テーブルを直接見る場合と件数が違うことがあります。
  件数を比べるときは、アクセス制御の影響も確かめるとよいでしょう。
• データが表示されない・権限のエラーになる: 見るテーブルの表示権限が足りないことがあります。
  エラーのメッセージを権限の管理者に伝えて、確かめてもらうとよいでしょう。

まとめ

• データプレビューは、テーブルを開いて「Run」→「Run As」→「1 ABAP Application」(F8)で開きます。
  「Add Filter」で絞り込み、「Number of Entries」で件数を数え、「Show Log」で裏の SELECT 文を確かめられます。
• SQL コンソールは、プロジェクトの右クリック、またはデータプレビューの「SQL Console」で開きます。
  新しい ABAP SQL の構文で SELECT 文を書き、「Run」で結果を見ます。INNER JOIN での結合や、GROUP BY・COUNT での集計も書けます。
• 取り出す件数の上限は「Max. Rows」で指定します。前に流した文は、「Run」の右の ▼ から呼び出せます。