Partilhar via


Containers class

Operações para criar novos contêineres e ler/consultar todos os contêineres

Consulte de contêiner para ler, substituir ou excluir um contêiner existente; use .container(id).

Nota: todas estas operações fazem chamadas contra um orçamento fixo. Você deve projetar seu sistema de modo que essas chamadas sejam dimensionadas sublinearmente com seu aplicativo. Por exemplo, não ligue para containers.readAll() antes de cada item.read() chamada, para garantir que o contêiner existe; Faça isso uma vez na inicialização do aplicativo.

Construtores

Containers(Database, ClientContext)

Propriedades

database

Métodos

create(ContainerRequest, RequestOptions)

Cria um contêiner.

Um contêiner é um contêiner lógico nomeado para itens.

Um banco de dados pode conter zero ou mais contêineres nomeados e cada contêiner consiste em zero ou mais itens JSON.

Sendo livres de esquema, os itens em um contêiner não precisam compartilhar a mesma estrutura ou campos.

Como os contêineres são recursos de aplicativos, eles podem ser autorizados usando a chave mestra ou chaves de recurso.

createIfNotExists(ContainerRequest, RequestOptions)

Verifica se existe um Contêiner e, se não existir, cria-o. Isso fará uma operação de leitura com base no id no bodye, se não for encontrado, uma operação de criação. Você deve confirmar se a saída corresponde ao corpo que você passou para propriedades não padrão (ou seja, política de indexação/etc.)

Um contêiner é um contêiner lógico nomeado para itens.

Um banco de dados pode conter zero ou mais contêineres nomeados e cada contêiner consiste em zero ou mais itens JSON.

Sendo livres de esquema, os itens em um contêiner não precisam compartilhar a mesma estrutura ou campos.

Como os contêineres são recursos de aplicativos, eles podem ser autorizados usando a chave mestra ou chaves de recurso.

query(SqlQuerySpec, FeedOptions)

Consulta todos os contêineres.

Exemplo

Leia todos os contêineres para matriz. * 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)

Consulta todos os contêineres.

Exemplo

Leia todos os contêineres para matriz. * 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)

Leia todos os recipientes.

Exemplo

Leia todos os contêineres para matriz. * typescript * const {body: containerList} = await client.database("<db id>").containers.readAll().fetchAll(); *

Detalhes do Construtor

Containers(Database, ClientContext)

new Containers(database: Database, clientContext: ClientContext)

Parâmetros

database
Database
clientContext

ClientContext

Detalhes de Propriedade

database

database: Database

Valor de Propriedade

Detalhes de Método

create(ContainerRequest, RequestOptions)

Cria um contêiner.

Um contêiner é um contêiner lógico nomeado para itens.

Um banco de dados pode conter zero ou mais contêineres nomeados e cada contêiner consiste em zero ou mais itens JSON.

Sendo livres de esquema, os itens em um contêiner não precisam compartilhar a mesma estrutura ou campos.

Como os contêineres são recursos de aplicativos, eles podem ser autorizados usando a chave mestra ou chaves de recurso.

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

Parâmetros

body
ContainerRequest

Representa o corpo do contêiner.

options
RequestOptions

Use para definir opções como tamanho da página de resposta, tokens de continuação, etc.

Devoluções

createIfNotExists(ContainerRequest, RequestOptions)

Verifica se existe um Contêiner e, se não existir, cria-o. Isso fará uma operação de leitura com base no id no bodye, se não for encontrado, uma operação de criação. Você deve confirmar se a saída corresponde ao corpo que você passou para propriedades não padrão (ou seja, política de indexação/etc.)

Um contêiner é um contêiner lógico nomeado para itens.

Um banco de dados pode conter zero ou mais contêineres nomeados e cada contêiner consiste em zero ou mais itens JSON.

Sendo livres de esquema, os itens em um contêiner não precisam compartilhar a mesma estrutura ou campos.

Como os contêineres são recursos de aplicativos, eles podem ser autorizados usando a chave mestra ou chaves de recurso.

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

Parâmetros

body
ContainerRequest

Representa o corpo do contêiner.

options
RequestOptions

Use para definir opções como tamanho da página de resposta, tokens de continuação, etc.

Devoluções

query(SqlQuerySpec, FeedOptions)

Consulta todos os contêineres.

Exemplo

Leia todos os contêineres para matriz. * 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>

Parâmetros

query
SqlQuerySpec

Configuração de consulta para a operação. Consulte SqlQuerySpec para obter mais informações sobre como configurar uma consulta.

options
FeedOptions

Use para definir opções como tamanho da página de resposta, tokens de continuação, etc.

Devoluções

QueryIterator Permite retornar contêineres específicos em uma matriz ou iterar sobre eles um de cada vez. *

query<T>(SqlQuerySpec, FeedOptions)

Consulta todos os contêineres.

Exemplo

Leia todos os contêineres para matriz. * 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>

Parâmetros

query
SqlQuerySpec

Configuração de consulta para a operação. Consulte SqlQuerySpec para obter mais informações sobre como configurar uma consulta.

options
FeedOptions

Use para definir opções como tamanho da página de resposta, tokens de continuação, etc.

Devoluções

QueryIterator Permite retornar contêineres específicos em uma matriz ou iterar sobre eles um de cada vez. *

readAll(FeedOptions)

Leia todos os recipientes.

Exemplo

Leia todos os contêineres para matriz. * typescript * const {body: containerList} = await client.database("<db id>").containers.readAll().fetchAll(); *

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

Parâmetros

options
FeedOptions

Use para definir opções como tamanho da página de resposta, tokens de continuação, etc.

Devoluções

QueryIterator Permite que você retorne todos os contêineres em uma matriz ou itere sobre eles um de cada vez. *