AI

生成AIにSQLやRのコードを書かせるコツ【そのまま使える指示文の例付き】

酒井 裕麻株式会社Bistro 代表取締役社長

SQLやRを書けるようになると、データ分析の幅は大きく広がります。とはいえ、関数の名前や書き方を一つひとつ覚えるのは大変です。いまは、ChatGPT・Gemini・ClaudeなどのAIにコードの下書きを書かせるのが当たり前になってきました。

ただし、AIに「売上を集計するSQLを書いて」とだけ頼んでも、自社のデータでそのまま動くコードはなかなか出てきません。この記事では、AIにSQLやRのコードを正しく、一発で動く形で書かせるためのコツを、指示文の例付きで解説します。

参考記事

ChatGPT・Gemini・Claudeの使い分け【データ分析・資料作成の実務で比べる】
SQL JOINの使い方【INNER・LEFT・FULL OUTERの違いを実行結果で解説】
dplyrでデータ加工入門【filter・select・mutate・group_by・summarise】

コツ1:テーブルの構造を伝える

AIは、あなたの会社のテーブルの中身を知りません。テーブル名・列名・型・1行が何を表すかを伝えるだけで、コードの精度は大きく上がります。

悪い例

注文データから、会員ランク別の売上を出すSQLを書いて

良い例

BigQueryで動くSQLを書いてください。

## テーブル
- shop.orders(1行=1注文)
  - order_id INT64, customer_id STRING, order_date DATE, store STRING, amount INT64
- shop.customers(1行=1顧客)
  - customer_id STRING, name STRING, rank STRING(ゴールド/シルバー/一般)

## やりたいこと
2026年3月の、会員ランク別の「顧客数・注文数・売上合計」を出したい。
注文のない顧客も、顧客数には含めたい。

ポイントは次の4つです。

伝えること 理由
データベースの種類(BigQuery、MySQL、Snowflakeなど) 日付の関数などの書き方が、データベースごとに違う
テーブル名と列名・型 存在しない列名を勝手に作られるのを防ぐ
1行が何を表すか 「1行=1注文」か「1行=1商品」かで、集計のしかたが変わる
条件や細かい要望 「注文のない顧客も含める」などがないと、INNER JOINで消えてしまう

列の一覧は、BigQueryならテーブルの「スキーマ」タブ、Rなら str(データ) や head(データ) の結果を、そのまま貼り付けるのが早くて確実です。

コツ2:サンプルデータと「期待する結果」を見せる

可能であれば、数行のサンプルデータと、欲しい結果の形を見せると、意図がずれにくくなります。

## 入力の例(ordersテーブルの一部)
order_id | customer_id | order_date | amount
1001     | C01         | 2026-03-02 | 4400
1003     | C01         | 2026-03-07 | 2500

## 欲しい結果の形
rank     | customers | orders | sales
ゴールド | 2         | 5      | 20300

※社外のAIサービスに貼り付けるときは、個人情報や社外秘のデータを含めないようにしましょう(後述)。サンプルは、列の形だけ同じダミーの値で十分です。

コツ3:エラーはそのまま貼る

AIが書いたコードを実行してエラーが出たら、エラーメッセージを省略せず、そのまま貼り付けて直してもらいます。

さきほどのSQLを実行したら、次のエラーが出ました。修正してください。

Unrecognized name: rank at [5:5]

「動きませんでした」だけでは、AIは原因を推測するしかありません。エラーメッセージには、どこの何が問題かが書かれているので、それを渡すのが一番の近道です。

コツ4:1つずつ頼んで、少しずつ組み立てる

複雑な集計を一度に頼むと、どこかで間違いが入り込みやすくなります。

  1. まず「3月の注文だけを取り出すSQL」を書いてもらい、実行して確かめる
  2. 次に「顧客テーブルとつないで、ランクを付ける」を追加してもらう
  3. 最後に「ランク別に集計する」を追加してもらう

このように1段階ずつ実行して確かめながら組み立てると、間違いに早く気づけます。各段階でWITH句(CTE)に分けて書いてもらうと、あとから読み返しやすいSQLになります。

コツ5:コードの説明もさせる

コードを受け取ったら、「このコードが何をしているか、1行ずつ説明して」と頼んでみましょう。

  • 自分の意図と違う処理(たとえば、意図しないINNER JOIN)に気づける
  • 説明を読むことで、SQLやRの書き方そのものの勉強にもなる
  • 後から別の人が見ても理解できるよう、コメント付きのコードにしてもらうのもおすすめ

コツ6:結果の数字は必ず確かめる

AIが書いたコードは、エラーが出ずに動いても、正しいとは限りません。特に集計の数字は、次のような方法で確かめましょう。

確かめ方 例
合計が合うか ランク別の売上を足すと、全体の売上と一致するか
件数が増えていないか JOINの前後で行数を比べる
1件だけ手で追う 特定の顧客1人について、元データから手計算した値と一致するか
別の方法で出してみる Excelのピボットテーブルや、GA4の画面の数字と比べる

社内データを扱うときの注意点

業務でAIを使うときは、コードの書き方と同じくらい、データの扱い方が大切です。

  • 個人情報や社外秘の数字を貼らない:コードを書いてもらうだけなら、列名と型、ダミーの数行で十分です
  • 会社のルールを確認する:使ってよいAIサービス、法人向けプランでの「入力したデータを学習に使わない」設定などを確認しましょう
  • 認証情報を貼らない:APIキーやパスワードが含まれたコードは、そのまま貼り付けないようにします

そのまま使える指示文のテンプレート

あなたはデータ分析のエキスパートです。次の条件で【BigQuery / R(tidyverse)】のコードを書いてください。

## データ
(テーブル名・列名・型・1行が何を表すかを書く)

## やりたいこと
(集計したい内容、期間、条件を書く)

## 出力の形
(欲しい結果の列と、並び順を書く)

## 条件
- 読みやすいように、処理の段階ごとにコメントを付けてください
- 前提を置いた場合は、コードの前に箇条書きで書いてください
- 結果が正しいかを確かめる方法も、1つ教えてください

最後の「前提を書いて」「確かめ方も教えて」の2行を入れておくと、AIが勝手に置いた前提に気づきやすくなり、確認の手間も減ります。

まとめ

  • テーブル名・列名・型・1行の意味を伝えると、コードの精度が上がる
  • サンプルデータと欲しい結果の形を見せると、意図がずれにくい
  • エラーメッセージは省略せずに貼る
  • 複雑な処理は、1段階ずつ実行して確かめながら組み立てる
  • 動いたコードでも、結果の数字は必ず確かめる
  • 個人情報や社外秘のデータは貼らない

AIは、コードを書く手間を大きく減らしてくれる心強い相棒です。一方で、「何を集計すべきか」「結果が正しいか」を判断するのは、データとビジネスを知っている人の役割です。この2つをうまく分担して、分析のスピードを上げていきましょう。

CONTACT

データ活用のお悩み、
直接相談しませんか。

「何から始めればいいかわからない」段階でも大丈夫です。課題の整理からお手伝いします。