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

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

필수 조건

• GitHub 계정
• Git
  • 이 자습서에서는 Git 명령 및 도구에 대한 기본적인 지식이 있다고 가정합니다.
• .NET 8

리포지토리를 포크하고 복제하세요

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

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

2. 본인의 계정 또는 조직에서 리포지토리의 복제본을 만듭니다. 계속하기 전에 포크 작업이 완료되기를 기다립니다.

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 컨테이너에서 실행