Kommandoradsgränssnittsreferens för Data API Builder
Kommandoradsgränssnittet för Data API Builder (CLI) (dab CLI eller dab) är ett kommandoradsverktyg som effektiviserar den lokala utvecklingsupplevelsen för program med hjälp av Data API Builder.
Tips
Data API Builder CLI levereras med ett integrerat hjälpsystem. Om du vill hämta en lista över vilka kommandon som är tillgängliga använder du --help alternativet i dab kommandot .
dab --help
Om du vill få hjälp med ett specifikt kommando använder du alternativet --help . Om du till exempel vill veta mer om init kommandot:
dab init --help
Kommandoradsverb och alternativ
init
Initierar körningskonfigurationen för Körningsmotorn för Data API Builder. Den skapar en ny JSON-fil med de egenskaper som anges som alternativ.
Syntax
dab init [options]
Exempel
dab init --config "dab-config.mssql.json" --database-type mssql --connection-string "@env('SQL_CONNECTION_STRING')"
dab init --database-type mysql --connection-string "@env('MYSQL_CONNECTION_STRING')" --graphql.multiple-create.enabled true
Alternativ
| Alternativ | Alternativ krävs | Standardvärde | Värde som krävs | Värdetyp | Description |
|---|---|---|---|---|---|
| --database-type | ✔️ Ja | ✔️ Ja | sträng | Typ av databas som ska anslutas. Värden som stöds: mssql, cosmosdb_nosql, cosmosdb_postgresql, mysql, postgresql. |
|
| --connection-string | ❌ Nej | "" |
✔️ Ja | sträng | Anslutningsinformation för att ansluta till databasen. |
| --cosmosdb_nosql-database | ✔️ Ja ¹ | ✔️ Ja | sträng | Databasnamn för Cosmos DB för NoSql. | |
| --cosmosdb_nosql-container | ❌ Nej | ✔️ Ja | sträng | Containernamn för Cosmos DB för NoSql. | |
| --graphql-schema | ✔️ Ja ¹ | ✔️ Ja | sträng | GraphQL-schemasökväg | |
| --set-session-context | ❌ Nej | false |
❌ Nej | Aktivera sändning av data till MsSql med hjälp av sessionskontext. | |
| --host-mode | ❌ Nej | production |
✔️ Ja | sträng | Ange värdläge – utveckling eller produktion |
| --cors-origin | ❌ Nej | "" |
✔️ Ja | sträng | Ange listan över tillåtna ursprung. |
| --auth.provider | ❌ Nej | StaticWebApps |
✔️ Ja | sträng | Ange identitetsprovidern. |
| --rest.path | ❌ Nej | /api |
✔️ Ja | sträng | Ange REST-slutpunktens prefix. |
| --rest.disabled | ❌ Nej | false |
❌ Nej | Inaktiverar REST-slutpunkt för alla entiteter. | |
| --rest.enabled | ❌ Nej | true |
✔️ Ja | Aktiverar REST-slutpunkt för alla entiteter. | |
| --rest.request-body-strict | ❌ Nej | true |
✔️ Ja | Tillåter inte överflödiga fält i begärandetexten. | |
| --graphql.path | ❌ Nej | /graphql |
✔️ Ja | sträng | Ange GraphQL-slutpunktens prefix. |
| --graphql.disabled | ❌ Nej | false |
❌ Nej | Inaktiverar GraphQL-slutpunkt för alla entiteter. | |
| --graphql.enabled | ❌ Nej | true |
✔️ Ja | Aktiverar GraphQL-slutpunkt för alla entiteter. | |
| --graphql.multiple-create.enabled | ❌ Nej | false |
✔️ Ja | Aktiverar flera funktioner för att skapa i GraphQL. | |
| --auth.audience | ❌ Nej | ✔️ Ja | sträng | Identifierar de mottagare som JSON-webbtoken (JWT) är avsedd för. | |
| --auth.issuer | ❌ Nej | ✔️ Ja | sträng | Ange den part som utfärdade JWT-token. | |
| -c,--config | ❌ Nej | dab-config.json |
✔️ Ja | sträng | Sökväg till konfigurationsfilen. |
¹ Det här alternativet krävs bara när --database-type är inställt på cosmosdb_nosql.
add
Lägg till en ny databasentitet i konfigurationsfilen. Kontrollera att du redan har en konfigurationsfil innan du kör det här kommandot, annars returneras ett fel.
Syntax
dab add [entity-name] [options]
Exempel
dab add Book -c "dab-config.MsSql.json" --source dbo.books --permissions "anonymous:*"
Alternativ
| Alternativ | Alternativ krävs | Standardvärde | Värde som krävs | Värdetyp | Description |
|---|---|---|---|---|---|
| -s,--källa | ✔️ Ja | ✔️ Ja | sträng | Namnet på källtabellen eller containern. | |
| --Behörigheter | ✔️ Ja | ✔️ Ja | sträng | Behörigheter som krävs för att komma åt källtabellen eller containern. Format: [role]:[actions]. |
|
| --source.type | ❌ Nej | table |
✔️ Ja | sträng | Typ av databasobjekt. Värden som stöds: table, view, stored-procedure. |
| --source.params | ❌ Nej | ✔️ Ja | sträng | Ordlista med parametrar och deras värden för källobjekt. param1:val1,param2:value2,... för Lagrade procedurer. |
|
| --source.key fält | ✔️ Ja ¹ | ✔️ Ja | sträng | Ett eller flera fält som endast ska användas som primärnycklar för tabeller och vyer. Kommaavgränsade värden. Exempel --source.key-fields "id,name,type". |
|
| --Resten | ❌ Nej | skiftlägeskänsligt entitetsnamn | ✔️ Ja | sträng | Väg för REST API. Exempel: --rest: false –> Inaktiverar REST API-anrop för den här entiteten. --rest: true –> Entitetsnamnet blir rest-sökvägen. --rest: "customPathName" –> Förutsatt att customPathName blir REST-sökvägen. |
| --rest.methods | ❌ Nej | post |
✔️ Ja | sträng | HTTP-åtgärder som ska stödjas för lagrad procedur. Ange åtgärderna som en kommaavgränsad lista. Giltiga HTTP-åtgärder är:[get, post, put, patch, delete]. |
| --graphql | ❌ Nej | skiftlägeskänsligt entitetsnamn | ✔️ Ja | Bool/Sträng | Entitetstyp som exponeras för GraphQL. Exempel: --graphql: false –> inaktiverar graphql-anrop för den här entiteten. --graphql: true –> Visar entiteten för GraphQL med standardnamn. Entitetsnamnets singularform beaktas för frågan och mutationsnamnen. --graphql: "customQueryName" -> Anger uttryckligen singularvärdet medan DAB pluraliserar det angivna värdet för frågor och mutationer. --graphql: "singularName:pluralName" –> Anger både singular- och pluralvärden (avgränsade med ett kolon :) som används för frågor och mutationer. |
| --graphql.operation | ❌ Nej | mutation |
✔️ Ja | sträng | GraphQL-åtgärd som ska stödjas för lagrad procedur. Värden som stöds: query, mutation. |
| --fields.include | ❌ Nej | ✔️ Ja | sträng | Fält med behörighet att komma åt. | |
| --fields.exclude | ❌ Nej | ✔️ Ja | sträng | Fält som undantas från åtgärdslistorna. | |
| --policy-database | ❌ Nej | ✔️ Ja | sträng | Ange en filterregel för OData-format som matas in i frågan som skickas till databasen. | |
| -c,--config | ❌ Nej | dab-config.json |
✔️ Ja | sträng | Sökväg till konfigurationsfilen. |
¹ Det här alternativet krävs bara när --source.type är inställt på view.
update
Uppdatera egenskaperna för en databasentitet i konfigurationsfilen.
Anteckning
dab update stöder alla alternativ som stöds av dab add. Dessutom har den även stöd för alternativen i listan.
Syntax
dab update [entity-name] [options]
Exempel
dab update Publisher --permissions "authenticated:*"
Alternativ
| Alternativ | Alternativ krävs | Standardvärde | Värde som krävs | Värdetyp | Description |
|---|---|---|---|---|---|
| --Förhållande | ❌ Nej | ✔️ Ja | sträng | Ange relationen mellan två entiteter. Ange namnet på relationen. | |
| --Kardinalitet | ✔️ Ja ¹ | ✔️ Ja | sträng | Ange kardinalitet mellan två entiteter. Kan vara en eller flera. | |
| --target.entity | ✔️ Ja ¹ | ✔️ Ja | sträng | En annan exponerad entitet som källentiteten relaterar till. | |
| --linking.object | ❌ Nej | ✔️ Ja | sträng | Databasobjekt som används för att stödja en M:N-relation. | |
| --linking.source.fields | ❌ Nej | ✔️ Ja | sträng | Databasfält i länkobjektet för att ansluta till det relaterade objektet i källentiteten. Kommaavgränsade fält. | |
| --linking.target.fields | ❌ Nej | ✔️ Ja | sträng | Databasfält i länkobjektet för att ansluta till det relaterade objektet i målentiteten. Kommaavgränsade fält. | |
| --relationship.fields | ❌ Nej | ✔️ Ja | sträng | Ange fält som ska användas för att mappa entiteterna. Exempel: --relationship.fields "id:book_id". id Här representerar kolumnen från sourceEntity, från book_id targetEntity. Sekundärnycklar krävs mellan de underliggande källorna om de inte anges. |
|
| -m,--mappning | ❌ Nej | ✔️ Ja | sträng | Ange mappningar mellan databasfält och GraphQL- och REST-fält. Format: --map "backendName1:exposedName1, backendName2:exposedName2,...". |
¹ Det här alternativet krävs bara när --relationship alternativet används.
export
Exportera det obligatoriska schemat som en fil och spara på disk baserat på alternativen.
Syntax
dab export [options]
Exempel
dab export --graphql -o ./schemas
Alternativ
| Alternativ | Alternativ krävs | Standardvärde | Värde som krävs | Värdetyp | Description |
|---|---|---|---|---|---|
| --graphql | ❌ Nej | false |
❌ Nej | Exportera GraphQL-schema. | |
| -o,--utdata | ✔️ Ja | ✔️ Ja | sträng | Ange den katalog som schemafilen ska sparas i. | |
| -g,--graphql-schema-file | ❌ Nej | schema.graphql |
✔️ Ja | sträng | Ange namnet på Graphql-schemafilen. |
| -c,--config | ❌ Nej | dab-config.json |
✔️ Ja | sträng | Sökväg till konfigurationsfilen. |
start
Starta körningsmotorn med den angivna konfigurationsfilen för att hantera REST- och GraphQL-begäranden.
Syntax
dab start [options]
Exempel
dab start
Alternativ
| Alternativ | Alternativ krävs | Standardvärde | Värde som krävs | Värdetyp | Description |
|---|---|---|---|---|---|
| --Utförlig | ❌ Nej | ❌ Nej | Ange loggningsnivå som information. | ||
| --LogLevel | ❌ Nej | Debug när hostMode=development, annars Error när HostMode=Production |
✔️ Ja | sträng | Ange loggningsnivå som angivet värde. exempel: felsökning, fel, information osv. |
| --no-https-redirect | ❌ Nej | false |
✔️ Ja | sträng | Inaktiverar automatiska https-omdirigeringar. |
| -c,--config | ❌ Nej | dab-config.json |
✔️ Ja | sträng | Sökväg till konfigurationsfilen. |
Anteckning
Du kan inte använda --verbose och --LogLevel på samma gång. Mer information om olika loggningsnivåer finns i .NET-loggnivåer.
validate
Verifierar körningskonfigurationsfilen som används av körningsmotorn för Data API Builder. Valideringsprocessen säkerställer att konfigurationsfilen är kompatibel med schemat och innehåller all information som krävs för att körningsmotorn ska fungera korrekt.
Syntax
dab validate [options]
Exempel
dab validate
Alternativ
| Alternativ | Alternativ krävs | Standardvärde | Värde som krävs | Värdetyp | Description |
|---|---|---|---|---|---|
| -c,--config | ❌ Nej | dab-config.json |
✔️ Ja | sträng | Sökväg till konfigurationsfilen som är målet för verifieringen. |