データ API ビルダー (DAB) は、GitHub でホストされているオープンソース プロジェクトです。 いつでも、ソース コードをダウンロードし、コードを変更し、ソースから直接プロジェクトを実行できます。 このガイドには、プロジェクトをソース コードから直接ビルドするために必要なすべての手順が含まれています。
[前提条件]
- GitHub アカウント
-
Git
- このチュートリアルでは、Git コマンドとツールに関する基本的な知識を前提としています。
- .NET 8
リポジトリをフォークして複製する
まず、 azure/data-api-builder GitHub リポジトリの独自のフォークを作成します。 このフォークを使用すると、独自の変更を保持できます。 その場合は、いつでもプル要求を開き、アップストリーム リポジトリへの変更を提案できます。
自分のアカウントまたは組織にリポジトリのフォークを作成します。 フォーク操作が完了するまで待ってから続行します。
新しいターミナルを開きます。
フォークを複製します。
git clone https://github.com/<your-username>/data-api-builder.gitヒント
または、フォークまたは元のリポジトリを GitHub Codespace として開く方法があります。
src/Azure.DataApiBuilder.slnソリューションをビルドします。dotnet build src/Azure.DataApiBuilder.sln
エンジンを実行する
Azure.DataApiBuilder ソリューションには、複数のプロジェクトが含まれています。 ソースからツールを実行するには、構成ファイルを渡して Azure.DataApiBuilder.Service プロジェクトを実行します。
ルート ディレクトリで、
dab-config.jsonという名前の新しいファイルを作成します。ヒント
.gitignore ファイルは、DAB 構成ファイルを自動的に無視します。
構成ファイルに次の内容を追加します。
{ "$schema": "https://github.com/Azure/data-api-builder/releases/latest/download/dab.draft.schema.json", "data-source": { "database-type": "mssql", "connection-string": "Server=localhost,1433;Initial Catalog=Library;User Id=sa;Password=<your-password>;TrustServerCertificate=true;" }, "entities": { "book": { "source": "dbo.Books", "permissions": [ { "actions": [ "read" ], "role": "anonymous" } ] } } }Von Bedeutung
これは、ローカル コンピューターで使用できる SQL Server があることを前提としたサンプル構成です。 実行しない場合は、サンプル データを使用して SQL Server 用の Docker コンテナーを実行できます。 詳細については、 サンプル データの作成を参照してください。
src/Service/Azure.DataApiBuilder.Service.csprojプロジェクトを実行します。--ConfigFileName引数を使用して、前の手順で作成した構成ファイルを指定します。dotnet run --project src/Service/Azure.DataApiBuilder.Service.csproj --ConfigFileName ../../dab-config.jsonヒント
データ API ビルダー エンジンは、同じフォルダー内の
dab-config.jsonファイルから構成を読み込もうとします (存在する場合)。dab-config.jsonファイルがない場合、エンジンはとにかく起動しますが、何も提供できません。