生成AIにSQLやRのコードを書かせるコツ【そのまま使える指示文の例付き】
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つずつ頼んで、少しずつ組み立てる
複雑な集計を一度に頼むと、どこかで間違いが入り込みやすくなります。
- まず「3月の注文だけを取り出すSQL」を書いてもらい、実行して確かめる
- 次に「顧客テーブルとつないで、ランクを付ける」を追加してもらう
- 最後に「ランク別に集計する」を追加してもらう
このように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つをうまく分担して、分析のスピードを上げていきましょう。
NEWSLETTER
Data Schoolの新着記事をメールで受け取る
新しい記事が公開されたら、メールでお知らせします。配信はいつでも停止できます。
