puda-database

データベースクエリ

puda CLI と SQL を使用して puda データベースをクエリします。

目的

このスキルを使うと、puda データベースのスキーマを把握し、puda CLI を介して SQL 文を実行できます。

使用するタイミング

次のような場合にこのスキルを読み込んでください：

• puda データベースのデータをクエリまたは確認したい場合
• SQL を記述する前にテーブルとカラムの構造を把握したい場合
• アドホックな SQL を実行する場合（例：command_name で command_log を絞り込む）

必要なリソース

重要：SQL を記述または実行する前に、スキーマを確認してください：

1. スキーマ：puda db schema を実行して、テーブル、カラム、型を確認します。正しい SQL を記述し、無効なカラム名やテーブル名を避けるために使用してください。

テーブル名やカラム名を推測せず、まず puda db schema で確認してください。

生物学的機器のコマンドからデータを取得する場合：データは常に payload の payload["response"]["data"] にあります。

コマンド

• puda db schema – データベースのスキーマ（テーブルとカラム）を出力します。SQL を記述する前に構造を把握するために使用します。
• puda db exec "<SQL>" – 単一の SQL 文を実行します。SQL は引用符で囲んだ文字列として渡します。

例

puda db exec "SELECT * FROM command_log WHERE command_name='start'"

手順

1. スキーマを確認する：SQL を記述する前に puda db schema を実行して、テーブルとカラムを把握します。
2. SQL を実行する：SQL を二重引用符で囲み、puda db exec "<SQL>" を使用します。必要に応じて、シェルで内部の引用符をエスケープしてください。
3. 出力を解析する：コマンドの出力を読み、成功したことを確認するか、後続の手順で結果データを使用します。