Delen via


Containers class

Bewerkingen voor het maken van nieuwe containers en het lezen/opvragen van alle containers

Zie Container voor het lezen, vervangen of verwijderen van een bestaande container. gebruik .container(id).

Opmerking: al deze bewerkingen voeren aanroepen uit tegen een vast budget. U moet uw systeem zo ontwerpen dat deze aanroepen sublineair worden geschaald met uw toepassing. Roep bijvoorbeeld niet containers.readAll() aan vóór elke aanroep item.read() om ervoor te zorgen dat de container bestaat. Doe dit eenmaal bij het opstarten van de toepassing.

Constructors

Containers(Database, ClientContext)

Eigenschappen

database

Methoden

create(ContainerRequest, RequestOptions)

Hiermee maakt u een container.

Een container is een logische container met de naam voor items.

Een database kan nul of meer benoemde containers bevatten en elke container bestaat uit nul of meer JSON-items.

Omdat de items in een container schemavrij zijn, hoeven ze niet dezelfde structuur of velden te delen.

Omdat containers toepassingsresources zijn, kunnen ze worden geautoriseerd met behulp van de hoofdsleutel of resourcesleutels.

createIfNotExists(ContainerRequest, RequestOptions)

Hiermee wordt gecontroleerd of er een container bestaat en, als dat niet het probleem is, wordt deze gemaakt. Hiermee wordt een leesbewerking gemaakt op basis van de id in de body, en als deze niet wordt gevonden, een maakbewerking. Controleer of de uitvoer overeenkomt met de hoofdtekst die u hebt doorgegeven voor niet-standaardeigenschappen (bijvoorbeeld indexeringsbeleid/etc.)

Een container is een logische container met de naam voor items.

Een database kan nul of meer benoemde containers bevatten en elke container bestaat uit nul of meer JSON-items.

Omdat de items in een container schemavrij zijn, hoeven ze niet dezelfde structuur of velden te delen.

Omdat containers toepassingsresources zijn, kunnen ze worden geautoriseerd met behulp van de hoofdsleutel of resourcesleutels.

query(SqlQuerySpec, FeedOptions)

Query's uitvoeren op alle containers.

Voorbeeld

Lees alle containers naar matrix. * typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @container", * parameters: [ * {name: "@container", value: "Todo"} * ] * }; * const {body: containerList} = await client.database("<db id>").containers.query(querySpec).fetchAll(); *

query<T>(SqlQuerySpec, FeedOptions)

Query's uitvoeren op alle containers.

Voorbeeld

Lees alle containers naar matrix. * typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @container", * parameters: [ * {name: "@container", value: "Todo"} * ] * }; * const {body: containerList} = await client.database("<db id>").containers.query(querySpec).fetchAll(); *

readAll(FeedOptions)

Alle containers lezen.

Voorbeeld

Lees alle containers naar matrix. * typescript * const {body: containerList} = await client.database("<db id>").containers.readAll().fetchAll(); *

Constructordetails

Containers(Database, ClientContext)

new Containers(database: Database, clientContext: ClientContext)

Parameters

database
Database
clientContext

ClientContext

Eigenschapdetails

database

database: Database

Waarde van eigenschap

Methodedetails

create(ContainerRequest, RequestOptions)

Hiermee maakt u een container.

Een container is een logische container met de naam voor items.

Een database kan nul of meer benoemde containers bevatten en elke container bestaat uit nul of meer JSON-items.

Omdat de items in een container schemavrij zijn, hoeven ze niet dezelfde structuur of velden te delen.

Omdat containers toepassingsresources zijn, kunnen ze worden geautoriseerd met behulp van de hoofdsleutel of resourcesleutels.

function create(body: ContainerRequest, options?: RequestOptions): Promise<ContainerResponse>

Parameters

body
ContainerRequest

Vertegenwoordigt de hoofdtekst van de container.

options
RequestOptions

Gebruik om opties in te stellen, zoals de grootte van de antwoordpagina, vervolgtokens, enzovoort.

Retouren

createIfNotExists(ContainerRequest, RequestOptions)

Hiermee wordt gecontroleerd of er een container bestaat en, als dat niet het probleem is, wordt deze gemaakt. Hiermee wordt een leesbewerking gemaakt op basis van de id in de body, en als deze niet wordt gevonden, een maakbewerking. Controleer of de uitvoer overeenkomt met de hoofdtekst die u hebt doorgegeven voor niet-standaardeigenschappen (bijvoorbeeld indexeringsbeleid/etc.)

Een container is een logische container met de naam voor items.

Een database kan nul of meer benoemde containers bevatten en elke container bestaat uit nul of meer JSON-items.

Omdat de items in een container schemavrij zijn, hoeven ze niet dezelfde structuur of velden te delen.

Omdat containers toepassingsresources zijn, kunnen ze worden geautoriseerd met behulp van de hoofdsleutel of resourcesleutels.

function createIfNotExists(body: ContainerRequest, options?: RequestOptions): Promise<ContainerResponse>

Parameters

body
ContainerRequest

Vertegenwoordigt de hoofdtekst van de container.

options
RequestOptions

Gebruik om opties in te stellen, zoals de grootte van de antwoordpagina, vervolgtokens, enzovoort.

Retouren

query(SqlQuerySpec, FeedOptions)

Query's uitvoeren op alle containers.

Voorbeeld

Lees alle containers naar matrix. * typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @container", * parameters: [ * {name: "@container", value: "Todo"} * ] * }; * const {body: containerList} = await client.database("<db id>").containers.query(querySpec).fetchAll(); *

function query(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<any>

Parameters

query
SqlQuerySpec

Queryconfiguratie voor de bewerking. Zie SqlQuerySpec voor meer informatie over het configureren van een query.

options
FeedOptions

Gebruik om opties in te stellen, zoals de grootte van de antwoordpagina, vervolgtokens, enzovoort.

Retouren

QueryIterator Hiermee kunt u specifieke containers in een matrix retourneren of deze één voor één herhalen. *

query<T>(SqlQuerySpec, FeedOptions)

Query's uitvoeren op alle containers.

Voorbeeld

Lees alle containers naar matrix. * typescript * const querySpec: SqlQuerySpec = { * query: "SELECT * FROM root r WHERE r.id = @container", * parameters: [ * {name: "@container", value: "Todo"} * ] * }; * const {body: containerList} = await client.database("<db id>").containers.query(querySpec).fetchAll(); *

function query<T>(query: SqlQuerySpec, options?: FeedOptions): QueryIterator<T>

Parameters

query
SqlQuerySpec

Queryconfiguratie voor de bewerking. Zie SqlQuerySpec voor meer informatie over het configureren van een query.

options
FeedOptions

Gebruik om opties in te stellen, zoals de grootte van de antwoordpagina, vervolgtokens, enzovoort.

Retouren

QueryIterator Hiermee kunt u specifieke containers in een matrix retourneren of deze één voor één herhalen. *

readAll(FeedOptions)

Alle containers lezen.

Voorbeeld

Lees alle containers naar matrix. * typescript * const {body: containerList} = await client.database("<db id>").containers.readAll().fetchAll(); *

function readAll(options?: FeedOptions): QueryIterator<ContainerDefinition & Resource>

Parameters

options
FeedOptions

Gebruik om opties in te stellen, zoals de grootte van de antwoordpagina, vervolgtokens, enzovoort.

Retouren

QueryIterator Hiermee kunt u alle containers in een matrix retourneren of ze één voor één herhalen. *