소스 코드에서 데이터 API 작성기 빌드 및 실행

DAB(데이터 API 작성기)는 GitHub에서 호스트되는 오픈 소스 프로젝트입니다. 언제든지 소스 코드를 다운로드하고, 코드를 수정하고, 소스에서 직접 프로젝트를 실행할 수 있습니다. 이 가이드에는 소스 코드에서 직접 프로젝트를 빌드하는 데 필요한 모든 단계가 포함되어 있습니다.

사전 요구 사항

• GitHub 계정
• Git
  • 이 자습서에서는 Git 명령 및 도구에 대한 기본적인 친숙함을 가정합니다.
• .NET 8

리포지토리 포크 및 복제

GitHub 리포지토리의 고유한 포크를 azure/data-api-builder 만들어 시작합니다. 이 포크를 사용하면 고유한 변경 내용을 유지할 수 있습니다. 이렇게 선택하면 항상 끌어오기 요청을 열고 업스트림 리포지토리에 대한 변경 내용을 제안할 수 있습니다.

1. https://github.com/azure/data-api-builder/fork로 이동합니다.

2. 사용자 계정 또는 organization 리포지토리의 포크를 Create. 계속하기 전에 포크 작업이 완료되기를 기다립니다.

3. 새 터미널을 엽니다.

4. 포크를 복제합니다.

   git clone https://github.com/<your-username>/data-api-builder.git
   

   팁

   또는 포크 또는 원래 리포지토리를 GitHub Codespace로 열 수 있습니다.

5. 솔루션을 빌드합니다 src/Azure.DataApiBuilder.sln .

   dotnet build src/Azure.DataApiBuilder.sln
   

엔진 실행

솔루션에는 Azure.DataApiBuilder 여러 프로젝트가 포함됩니다. 원본에서 도구를 실행하려면 구성 파일을 전달하는 프로젝트를 실행 Azure.DataApiBuilder.Service 합니다.

1. 루트 디렉터리에서 라는 dab-config.json새 파일을 만듭니다.

   팁

   .gitignore 파일은 DAB 구성 파일을 자동으로 무시합니다.

2. 구성 파일에 다음 콘텐츠를 추가합니다.

   {
     "$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"
           }
         ]
       }
     }
   }
   

   중요

   로컬 컴퓨터에서 사용할 수 있는 SQL Server 있다고 가정하는 샘플 구성입니다. 그렇지 않은 경우 샘플 데이터로 SQL Server Docker 컨테이너를 실행할 수 있습니다. 자세한 내용은 샘플 데이터 만들기를 참조하세요.

3. 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 으면 엔진이 어쨌든 시작되지만 아무 것도 제공할 수 없습니다.

관련 콘텐츠

• azure/data-api-builder GitHub에서
• Docker 컨테이너에서 실행