@azure/cosmos package

Classes

AbortError

Esse erro é gerado quando uma operação assíncrona é anulada. Verifique se esse erro está testando o name de que a propriedade de nome do erro corresponde "AbortError".

exemplo

const controller = new AbortController();
controller.abort();
try {
  doAsyncWork(controller.signal)
} catch (e) {
  if (e.name === 'AbortError') {
    // handle abort error here.
  }
}
ChangeFeedIterator

Fornece o iterador para o feed de alterações.

Use Items.changeFeed() para obter uma instância do iterador.

ChangeFeedIteratorResponse

Uma única página de resposta do Feed de Alterações do Azure Cosmos DB

ChangeFeedPolicy

Representa a configuração da política de feed de alterações para um contêiner no serviço do Azure Cosmos DB.

ChangeFeedResponse

Uma única página de resposta do Feed de Alterações do Azure Cosmos DB

ChangeFeedRetentionTimeSpan
ChangeFeedStartFrom

Classe base para onde iniciar um ChangeFeedIterator.

ClientSideMetrics
Conflict

Use para ler ou excluir uma determinada de Conflito de por ID.

Consulte Conflitos para consultar ou ler todos os conflitos.

ConflictResponse
Conflicts

Use para consultar ou ler todos os conflitos.

Consulte de Conflito para ler ou excluir um determinado de Conflito de por ID.

Container

Operações para ler, substituir ou excluir um contêiner específico existente por ID.

Consulte contêineres para criar novos contêineres e ler/consultar todos os contêineres; use .containers.

Observação: todas essas operações fazem chamadas em relação a um orçamento fixo. Você deve projetar seu sistema de modo que essas chamadas sejam dimensionadas sublinearmente com seu aplicativo. Por exemplo, não chame container(id).read() antes de cada chamada item.read(), para garantir que o contêiner exista; faça isso uma vez na inicialização do aplicativo.

ContainerResponse

Objeto de resposta para operações de contêiner

Containers

Operações para criar novos contêineres e leitura/consulta de todos os contêineres

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

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

CosmosClient

Fornece uma representação lógica do lado do cliente da conta de banco de dados do Azure Cosmos DB. Esse cliente é usado para configurar e executar solicitações no serviço de banco de dados do Azure Cosmos DB.

exemplo

Instanciar um cliente e criar um novo banco de dados

const client = new CosmosClient({endpoint: "<URL HERE>", key: "<KEY HERE>"});
await client.databases.create({id: "<database name here>"});

exemplo

Criar uma instância de um cliente com a Política de Conexão personalizada

const client = new CosmosClient({
   endpoint: "<URL HERE>",
   key: "<KEY HERE>",
   connectionPolicy: {
    requestTimeout: 10000,
   },
});
CosmosDiagnostics
  • Esse é um tipo de Diagnóstico do Cosmos que contém informações de diagnóstico coletadas durante operações de cliente. Ie. Item.read(), Container.create(). Tem três membros -
  1. clientSideRequestStatistics membro contém informações de diagnóstico agregadas, incluindo -
  • pesquisas de metadados. Aqui, todas as solicitações de servidor, além do recurso final pretendido, são consideradas como chamadas de metadados. Ou seja, para item.read(id), se o cliente fizer uma chamada de servidor para descobrir pontos de extremidade, ele será considerado como chamada de metadados.
  • Tentativas
  • pontos de extremidade contatados.
  • solicitação, estatísticas de conteúdo de resposta.
  • gatewayStatistics – Informações correspondentes à operação principal. Por exemplo, durante Item.read(), o cliente pode executar muitas operações, ou seja, pesquisa de metadados etc, mas gatewayStatistics representa as informações de diagnóstico para a operação de leitura real.
  1. diagnosticNode – É uma estrutura semelhante a uma árvore que captura informações detalhadas de diagnóstico. Por padrão, ele está desabilitado e destina-se a ser usado apenas para depuração em ambientes não de produção. O tipo de detalhes capturados no diagnosticNode é controlado por CosmosDbDiagnosticLevel.
  • CosmosDbDiagnosticLevel.info – é o valor padrão. Nesse nível, somente clientSideRequestStatistics são capturados. Destina-se a ambientes de produção.
  • CosmosDbDiagnosticLevel.debug – Captura diagnosticNode e clientConfig. Nenhum conteúdo de solicitação e resposta é capturado. Não é para ser usado no ambiente de produção.
  • CosmosDbDiagnosticLevel.debug-unsafe – além dos dados capturados no CosmosDbDiagnosticLevel.debug, também captura cargas de solicitação e resposta. Não é para ser usado no ambiente de produção.
  1. clientConfig – captura informações relacionadas à forma como o cliente foi configurado durante a inicialização.
Database

Operações para ler ou excluir um banco de dados existente.

Consulte Bancos de Dados para criar novos bancos de dados e ler/consultar todos os bancos de dados; use client.databases.

Observação: todas essas operações fazem chamadas em relação a um orçamento fixo. Você deve projetar seu sistema de modo que essas chamadas sejam dimensionadas sublinearmente com seu aplicativo. Por exemplo, não chame database.read() antes de cada chamada item.read(), para garantir que o banco de dados exista; faça isso uma vez na inicialização do aplicativo.

DatabaseAccount

Representa um DatabaseAccount no serviço de banco de dados do Azure Cosmos DB.

DatabaseResponse

Objeto de resposta para operações de banco de dados

Databases

Operações para criar novos bancos de dados e ler/consultar todos os bancos de dados

Consulte banco de dados para ler ou excluir um banco de dados existente; use client.database(id).

Observação: todas essas operações fazem chamadas em relação a um orçamento fixo. Você deve projetar seu sistema de modo que essas chamadas sejam dimensionadas sublinearmente com seu aplicativo. Por exemplo, não chame databases.readAll() antes de cada chamada item.read(), para garantir que o banco de dados exista; faça isso uma vez na inicialização do aplicativo.

ErrorResponse
FeedRange

Especifica um intervalo de feeds para o feed de alterações.

FeedResponse
Item

Usado para executar operações em um item específico.

Consulte Itens para operações em todos os itens; ver container.items.

ItemResponse
Items

Operações para criar novos itens e ler/consultar todos os itens

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

Offer

Use para ler ou substituir uma oferta existente por ID.

Consulte Ofertas para consultar ou ler todas as ofertas.

OfferResponse
Offers

Use para consultar ou ler todas as Ofertas.

Consulte de oferta para ler ou substituir um de oferta de existente por ID.

PartitionKeyBuilder

Classe de construtor para a criação de PartitionKey.

Permission

Use para ler, substituir ou excluir uma determinada permissão de por ID.

Consulte Permissões para criar, upsert, consultar ou ler todas as Permissões.

PermissionResponse
Permissions

Use para criar, substituir, consultar e ler todas as Permissões.

Consulte Permissão para ler, substituir ou excluir uma permissão específica por ID.

QueryIterator

Representa um objeto QueryIterator, uma implementação de feed ou resposta de consulta que permite a passagem e a iteração sobre a resposta no serviço de banco de dados do Azure Cosmos DB.

QueryMetrics
QueryPreparationTimes
ResourceResponse
RestError

Um tipo de erro personalizado para solicitações de pipeline com falha.

RuntimeExecutionTimes
SasTokenProperties
Scripts
StoredProcedure

Operações para ler, substituir, excluir ou executar um procedimento armazenado específico e existente por ID.

Para operações para criar, ler tudo ou consultar procedimentos armazenados,

StoredProcedureResponse
StoredProcedures

Operações para criação, upserting ou leitura/consulta de todos os procedimentos armazenados.

Para que as operações leiam, substituam, excluam ou executem um procedimento armazenado específico e existente por ID, consulte container.storedProcedure().

TimeoutError
Trigger

Operações para ler, substituir ou excluir um gatilho .

Use container.triggers para criar, upsert, consultar ou ler tudo.

TriggerResponse
Triggers

Operações para criar, upsert, consultar e ler todos os gatilhos.

Use container.triggers para ler, substituir ou excluir um gatilho .

User

Usado para ler, substituir e excluir Usuários.

Além disso, você pode acessar as permissões para um determinado usuário por meio de user.permission e user.permissions.

Consulte Usuários para criar, upsert, consultar ou ler tudo.

UserDefinedFunction

Usado para ler, substituir ou excluir uma função de definição de usuário especificada por id.

Consulte UserDefinedFunction para criar, upsert, consultar, ler todas as funções definidas pelo usuário.

UserDefinedFunctionResponse
UserDefinedFunctions

Usado para criar, upsert, consultar ou ler todas as funções definidas pelo usuário.

Consulte UserDefinedFunction para ler, substituir ou excluir uma determinada função definida pelo usuário por id.

UserResponse
Users

Usado para criar, upsert, consultar e ler todos os usuários.

Consulte usuário para ler, substituir ou excluir um usuário específico por ID.

Interfaces

@azure/cosmos.Index
Agent
BulkOptions

Objeto Options usado para modificar a execução em massa. continueOnError (valor padrão: false) – Continua a execução em massa quando uma operação falha ** OBSERVAÇÃO ESTE PADRÃO SERÁ TRUE NA VERSÃO 4.0

ChangeFeedIteratorOptions

Especifica opções para o feed de alterações

Se nenhuma dessas opções estiver definida, ele começará a ler as alterações a partir de agora para todo o contêiner.

ChangeFeedOptions

Especifica opções para o feed de alterações

Algumas dessas opções controlam onde e quando começar a ler no feed de alterações. A ordem de precedência é:

  • continuação
  • startTime
  • startFromBeginning

Se nenhuma dessas opções estiver definida, ela começará a ler as alterações da primeira chamada ChangeFeedIterator.fetchNext().

ChangeFeedPullModelIterator

Use Items.getChangeFeedIterator() para retornar um iterador que pode iterar em todas as alterações para uma chave de partição, um intervalo de feed ou um contêiner inteiro.

CompositePath

Representa um caminho composto na política de indexação.

ComputedProperty
ConflictDefinition
ConflictResolutionPolicy

Representa a configuração de política de resolução de conflitos para especificar como resolver conflitos caso gravações de regiões diferentes resultem em conflitos em documentos na coleção no serviço do Azure Cosmos DB.

ConnectionPolicy

Representa a política de conexão associada a um CosmosClient no serviço de banco de dados do Azure Cosmos DB.

ContainerDefinition
ContainerRequest
CosmosClientOptions
CosmosHeaders
CreateOperationInput
DatabaseDefinition
DatabaseRequest
DeleteOperationInput
DiagnosticNode

Representa uma árvore como estrutura, para capturar informações de diagnóstico.

ErrorBody
FailedRequestAttemptDiagnostic

Esse tipo captura informações de diagnóstico sobre uma solicitação com falha na API do servidor.

FeedOptions

As opções de feed e os métodos de consulta.

GroupByAliasToAggregateType
IndexedPath
IndexingPolicy
ItemDefinition

Os itens no Cosmos DB são simplesmente objetos JSON. A maioria das operações item permite que você forneça seu próprio tipo que estende o ItemDefinition muito simples.

Você não pode usar chaves reservadas. Você pode ver a lista de chaves reservadas no <xref:ItemBody>

JSONArray
JSONObject
Location

Usado para especificar os locais disponíveis, leitura é índice 1 e gravação é índice 0.

MetadataLookUpDiagnostic

Esse tipo contém informações de diagnóstico sobre uma única solicitação de metadados para o servidor.

OfferDefinition
OperationBase
OperationResponse
PartitionKeyDefinition
PartitionKeyRangePropertiesNames
PatchOperationInput
PermissionBody
PermissionDefinition
ReadOperationInput
ReplaceOperationInput
RequestOptions

Opções que podem ser especificadas para um emitido solicitado para os servidores do Azure Cosmos DB.=

Resource
RetryOptions

Representa a política de repetição associada com solicitações limitadas no serviço de banco de dados do Azure Cosmos DB.

SharedOptions

Opções que podem ser especificadas para um emitido solicitado para os servidores do Azure Cosmos DB.=

SpatialIndex
SqlParameter

Representa um parâmetro em uma consulta SQL parametrizada, especificada em sqlQuerySpec

SqlQuerySpec

Representa uma consulta SQL no serviço do Azure Cosmos DB.

As consultas com entradas devem ser parametrizadas para proteger contra injeção de SQL.

exemplo

Consulta SQL parametrizada

const query: SqlQuerySpec = {
  query: "SELECT * FROM Families f where f.lastName = @lastName",
  parameters: [
    {name: "@lastName", value: "Wakefield"}
  ]
};
StoredProcedureDefinition
TriggerDefinition
UniqueKey

Interface para uma única chave exclusiva passada como parte do UniqueKeyPolicy

UniqueKeyPolicy

Interface para definir chaves exclusivas na criação de contêiner

UpsertOperationInput
UserDefinedFunctionDefinition
UserDefinition
VectorEmbedding

Representa uma inserção de vetor. Uma inserção de vetor é usada para definir um campo de vetor nos documentos.

VectorEmbeddingPolicy

Representa a configuração de política para inserções de vetor no serviço do Azure Cosmos DB.

VectorIndex

Representa um índice de vetor no serviço do Azure Cosmos DB. Um índice de vetor é usado para indexar campos de vetor nos documentos.

Aliases de tipo

AggregateType
BulkOperationResponse
BulkPatchOperation
ClientConfigDiagnostic

Esse tipo contém informações relacionadas à inicialização de CosmosClient

ClientSideRequestStatistics

Esse é um tipo de coleção para todas as informações de diagnóstico do lado do cliente.

CreateOperation
DeleteOperation
ExistingKeyOperation
GatewayStatistics
GroupByExpressions
JSONValue
MetadataLookUpDiagnostics

Esse tipo contém informações de diagnóstico sobre todas as solicitações de metadados para o servidor durante uma operação de cliente do CosmosDB.

NonePartitionKeyType

O objeto retornado representa um valor de chave de partição que permite criar e acessar itens sem um valor para chave de partição

NullPartitionKeyType

O objeto retornado representa um valor de chave de partição que permite criar e acessar itens com um valor nulo para a chave de partição.

Operation
OperationInput
OperationWithItem
PartitionKey

PartitionKey de um contêiner.

PatchOperation
PatchRequestBody
PrimitivePartitionKeyValue

Um valor de chave de partição primitiva.

ReadOperation
RemoveOperation
ReplaceOperation
RetryDiagnostics

Esse tipo captura informações de diagnóstico sobre tentativas de repetição durante uma operação de cliente do CosmosDB.

TokenProvider
UpsertOperation

Enumerações

ChangeFeedMode
ConflictResolutionMode
ConnectionMode

Determina o comportamento de conexão do CosmosClient. Observe que, no momento, só oferecemos suporte ao Modo de Gateway.

ConsistencyLevel

Representa os níveis de consistência com suporte para operações de cliente do Azure Cosmos DB.
O ConsistencyLevel solicitado deve corresponder ou ser mais fraco do que o provisionado para a conta de banco de dados. Níveis de consistência.

Os níveis de consistência por ordem de força são Strong, BoundedStaleness, Session, Consistent Prefix e Eventual.

Consulte https://aka.ms/cosmos-consistency para obter uma documentação mais detalhada sobre níveis de consistência.

CosmosDbDiagnosticLevel

Nível de diagnóstico do Cosmos DB

DataType

Define um tipo de dados de destino de uma especificação de caminho de índice no serviço do Azure Cosmos DB.

GeospatialType
IndexKind

Especifica os tipos de índice com suporte.

IndexingMode

Especifica os modos de indexação com suporte.

MetadataLookUpType

Essa é uma enumeração possível para pesquisas de tipo de metadados.

PartitionKeyDefinitionVersion

Versão de definição partitionKey

PartitionKeyKind

Tipo de PartitionKey, ou seja, Hash, MultiHash

PermissionMode

Enumeração para valores de modo de permissão.

PriorityLevel

Representa o Nível de Prioridade associado a cada solicitação de cliente do Azure Cosmos DB.
As solicitações de baixa prioridade são sempre limitadas antes de qualquer solicitação de alta prioridade.

Por padrão, todas as solicitações são consideradas como solicitações de alta prioridade.

Consulte https://aka.ms/CosmosDB/PriorityBasedExecution para obter uma documentação mais detalhada sobre limitação baseada em prioridade.

SpatialType
TriggerOperation

Enumeração para valores de operação de gatilho. especifica as operações nas quais um gatilho deve ser executado.

TriggerType

Enumeração para valores de tipo de gatilho. Especifica o tipo do gatilho.

UserDefinedFunctionType

Enumeração para valores de tipo udf. Especifica os tipos de funções definidas pelo usuário.

VectorEmbeddingDataType

Representa o tipo de dados do vetor.

VectorEmbeddingDistanceFunction

Representa a função de distância a ser usada para o cálculo de distância entre vetores.

VectorIndexType

Representa o tipo de índice do vetor.

Funções

createAuthorizationSasToken(string, SasTokenProperties)

Interno experimental gera apenas o conteúdo que representa a configuração de permissão para o token sas.

Detalhes da função

createAuthorizationSasToken(string, SasTokenProperties)

Interno experimental gera apenas o conteúdo que representa a configuração de permissão para o token sas.

function createAuthorizationSasToken(masterKey: string, sasTokenProperties: SasTokenProperties): Promise<string>

Parâmetros

masterKey

string

sasTokenProperties
SasTokenProperties

Retornos

Promise<string>