この記事では、SQL データベース項目の定義構造の詳細について説明します。
サポートされるフォーマット
SQL データベース項目では、 dacpac 形式と sqlproj 形式がサポートされます。 形式が指定されていない場合、操作は既定で dacpacされます。
データ層アプリケーション パッケージ (dacpac) パーツ
dacpac パーツは、テーブル、ビュー、ストアド プロシージャなど、すべての SQL データベース オブジェクトを含むデータベース モデルを含むファイルです。
dacpac ファイルは、データベース スキーマを宣言型の方法でデプロイおよび管理するために使用され、dacpac モデルに一致するようにデータベースを更新するために必要な変更を動的に計算します。
dacpac ファイルは、Visual Studio Codeの SQL プロジェクト、SqlPackage コマンド ライン ユーティリティ、または dacpac 形式をサポートするその他のデータベース開発ツールを使用して作成できます。 SQL プロジェクトの詳細と dacpac ファイルの作成については、 SQL プロジェクトのドキュメント または SqlPackage の Fabric の SQL データベースに関する記事を参照してください。
dacpac形式の定義パーツ
次の表に、 dacpac SQL データベース定義パーツの一覧を示します。
| 定義パーツのパス | 型 | 必須 | Description |
|---|---|---|---|
sqldb.dacpac |
データ層アプリケーション パッケージ (dacpac) | true | dacpac (データベース モデル) ファイル |
.platform |
PlatformDetails (JSON) | false | アイテムの一般的な詳細について説明します |
dacpac 形式を使用した定義ペイロードの例
{
"definition": {
"parts": [
{
"path": "sqldb.dacpac",
"payload": "<base64 encoded string>",
"payloadType": "InlineBase64"
},
{
"path": ".platform",
"payload": "<base64 encoded string>",
"payloadType": "InlineBase64"
}
]
}
}
SQL データベース プロジェクト (sqlproj) パーツ
SQL データベース プロジェクトは、テーブル、ストアド プロシージャ、関数など、単一データベースのスキーマを構成する SQL オブジェクトをローカルで表現したものです。 SQL データベース プロジェクトは、通常、ターゲット SQL データベースに配置する前にエラーを確認するために、 dacpac ファイルにビルドすることによってローカルでテストされます。 SQL データベース プロジェクトの構造はデータベース オブジェクトに依存します。Fabric の SQL データベースでは、既定でスキーマとオブジェクトの種類別にプロジェクト ファイルが整理されます。 たとえば、dbo スキーマのTable1という名前のテーブルは、dbo/Tables/Table1.sqlのファイル パスで表されます。 SQL プロジェクトの詳細については、 SQL プロジェクトのドキュメントを参照してください。
sqlproj形式の定義パーツ
次の表に、 sqlproj SQL データベース定義パーツの一覧を示します。
| 定義パーツのパス | 型 | 必須 | Description |
|---|---|---|---|
sqldb.sqlproj |
SQL データベース プロジェクト | true |
.sqlprojは、Microsoft.Build.Sql プロジェクトのプロジェクト ファイルです。 これは、 dacpac ファイルにビルドされ、ターゲット SQL データベースにデプロイされます。 定義ごとに受け入れられる SQL プロジェクト ファイル (.sqlproj) は 1 つだけです。 |
**/*.sql |
構造化クエリ言語 (SQL) ファイル | false | 1 つ以上の SQL オブジェクト定義ファイル。
.sqlproj ファイルによって明示的に除外されていないすべてのファイルが含まれます。 |
.sharedqueries/*.sql |
構造化クエリ言語 (SQL) ファイル | false | 1 つ以上の SQL クエリ ファイル。 これらのクエリは、共有クエリとしてデータベースにデプロイされ、エディターで使用できます。
.sharedqueries フォルダーは SQL プロジェクト ファイルから除外され、これらのクエリはビルド プロセスに含まれません。 |
.platform |
PlatformDetails (JSON) | false | アイテムの一般的な詳細について説明します |
sqlproj 形式を使用した定義ペイロードの例
{
"definition": {
"parts": [
{
"path": "sqldb.sqlproj",
"payload": "<base64 encoded string>",
"payloadType": "InlineBase64"
},
{
"path": "dbo/Tables/Table1.sql",
"payload": "<base64 encoded string>",
"payloadType": "InlineBase64"
},
{
"path": ".sharedqueries/query.sql",
"payload": "<base64 encoded string>",
"payloadType": "InlineBase64"
},
{
"path": ".platform",
"payload": "<base64 encoded string>",
"payloadType": "InlineBase64"
}
]
}
}