Tip

このドキュメントはAIによって翻訳されました。不正確な情報については、英語版をご参照ください

SQL コレクション

Collection: SQLCommunity Edition+

概要

SQL コレクションは、SQL クエリを使ってデータを取得する強力な方法を提供します。SQL クエリでデータフィールドを抽出し、関連するフィールドのメタデータを設定することで、ユーザーはこれらのフィールドを通常のテーブルと同じように利用できます。この機能は、複雑な結合クエリや統計分析などのシナリオで特に便利です。

利用ガイド

新規作成

  1. SQL 入力ボックスに SQL クエリを入力し、「実行 (Execute)」をクリックします。システムは、SQL で使用されているテーブルとフィールドを解析し、ソーステーブルから関連するフィールドのメタデータを自動的に抽出します。
  1. システムによるソーステーブルとフィールドの分析が正しくない場合は、手動で適切なテーブルとフィールドを選択し、正しいメタデータが使用されるように調整できます。まずソーステーブルを選択し、次に下のフィールドソースセクションで対応するフィールドを選択してください。
  1. 直接的なソースがないフィールドの場合、システムはデータ型に基づいてフィールドタイプを推測します。この推測が正しくない場合は、手動で適切なフィールドタイプを選択できます。
  1. 各フィールドを設定しながら、プレビューエリアでその表示をプレビューし、設定の即時的な影響を確認できます。
  1. 設定が完了し、すべてが正しいことを確認したら、SQL 入力ボックスの下にある「確認 (Confirm)」ボタンをクリックして、最終的な送信を完了します。

編集

  1. SQL クエリを変更する必要がある場合は、「変更 (Edit)」ボタンをクリックして、SQL ステートメントを直接変更し、必要に応じてフィールドを再設定します。

  2. フィールドのメタデータを調整するには、「フィールド設定 (Configure fields)」オプションを使用します。これにより、通常のテーブルと同じようにフィールド設定を更新できます。

同期

SQL クエリは変更されていないが、基になるデータベースのテーブル構造が変更された場合、「フィールド設定 (Configure fields)」-「データベースから同期 (Sync from Database)」を選択することで、フィールドを同期および再設定できます。

SQL コレクションと接続されたデータベースビューの比較

テンプレートタイプ最適なシナリオ実装方法CRUD 操作のサポート
SQLシンプルなモデル、軽量なユースケース
データベース操作が不便な場合
ビューのメンテナンスを避けたい場合
UI による操作を完全に希望する場合
SQL サブクエリサポートなし
データベースビューに接続複雑なモデル
データベースとの対話が必要な場合
データの変更が必要な場合
より堅牢で安定したデータベースサポートが必要な場合
データベースビュー部分的にサポート
Warning

SQL コレクションを使用する際は、NocoBase 内で管理可能なデータテーブルを選択してください。同じデータベース内であっても、NocoBase に接続されていない他のテーブルを使用すると、SQL クエリの解析が不正確になる可能性があります。このような要件がある場合は、ビューを作成して接続することを検討してください。