Partilhar via

Database.GetContainerQueryIterator Método

  • Referência

Definição

Namespace:
Microsoft.Azure.Cosmos
Assembly:
Microsoft.Azure.Cosmos.Client.dll
Pacote:
Microsoft.Azure.Cosmos v3.39.0

Sobrecargas

GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)

Esse método cria uma consulta para contêineres em um banco de dados usando uma instrução SQL com valores parametrizados. Ele retorna um FeedIterator. Para obter mais informações sobre como preparar instruções SQL com valores parametrizados, consulte QueryDefinition sobrecarga.
GetContainerQueryIterator<T>(String, String, QueryRequestOptions)

Esse método cria uma consulta para contêineres em um banco de dados usando uma instrução SQL. Ele retorna um FeedIterator.

GetContainerQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)

Origem:
Database.cs

Esse método cria uma consulta para contêineres em um banco de dados usando uma instrução SQL com valores parametrizados. Ele retorna um FeedIterator. Para obter mais informações sobre como preparar instruções SQL com valores parametrizados, consulte QueryDefinition sobrecarga.

public abstract Microsoft.Azure.Cosmos.FeedIterator<T> GetContainerQueryIterator<T> (Microsoft.Azure.Cosmos.QueryDefinition queryDefinition, string continuationToken = default, Microsoft.Azure.Cosmos.QueryRequestOptions requestOptions = default);
abstract member GetContainerQueryIterator : Microsoft.Azure.Cosmos.QueryDefinition * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator<'T>
Public MustOverride Function GetContainerQueryIterator(Of T) (queryDefinition As QueryDefinition, Optional continuationToken As String = Nothing, Optional requestOptions As QueryRequestOptions = Nothing) As FeedIterator(Of T)

Parâmetros de tipo

T

Parâmetros

queryDefinition
QueryDefinition

A definição de consulta SQL do Cosmos.

continuationToken
String

(Opcional) O token de continuação no serviço do Azure Cosmos DB.

requestOptions
QueryRequestOptions

(Opcional) As opções para a solicitação de consulta de item.

Retornos

FeedIterator<T>

Um iterador para percorrer os contêineres

Exemplos

Isso cria o iterador de feed de tipo para contêineres com queryDefinition como entrada.

QueryDefinition queryDefinition = new QueryDefinition("SELECT * FROM c where c.status like @status");
    .WithParameter("@status", "start%");
using (FeedIterator<ContainerProperties> feedIterator = this.cosmosDatabase.GetContainerQueryIterator<ContainerProperties>(queryDefinition))
{
    while (feedIterator.HasMoreResults)
    {
        FeedResponse<ContainerProperties> response = await feedIterator.ReadNextAsync();
        foreach (var container in response)
        {
            Console.WriteLine(container);
        }
    }
}

Comentários

Consulte para https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started obter sintaxe e exemplos.

ReadContainerAsync(ContainerRequestOptions, CancellationToken) é recomendado para pesquisa de contêiner único.

Aplica-se a

GetContainerQueryIterator<T>(String, String, QueryRequestOptions)

Origem:
Database.cs

Esse método cria uma consulta para contêineres em um banco de dados usando uma instrução SQL. Ele retorna um FeedIterator.

public abstract Microsoft.Azure.Cosmos.FeedIterator<T> GetContainerQueryIterator<T> (string queryText = default, string continuationToken = default, Microsoft.Azure.Cosmos.QueryRequestOptions requestOptions = default);
abstract member GetContainerQueryIterator : string * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator<'T>
Public MustOverride Function GetContainerQueryIterator(Of T) (Optional queryText As String = Nothing, Optional continuationToken As String = Nothing, Optional requestOptions As QueryRequestOptions = Nothing) As FeedIterator(Of T)

Parâmetros de tipo

T

Parâmetros

queryText
String

O texto da consulta SQL do Cosmos.

continuationToken
String

(Opcional) O token de continuação no serviço do Azure Cosmos DB.

requestOptions
QueryRequestOptions

(Opcional) As opções para a solicitação de consulta de item.

Retornos

FeedIterator<T>

Um iterador para percorrer os contêineres

Exemplos

  1. Isso cria o iterador de feed de tipo para contêineres com queryText como entrada,
string queryText = "SELECT * FROM c where c.status like 'start%'";
using (FeedIterator<ContainerProperties> feedIterator = this.cosmosDatabase.GetContainerQueryIterator<ContainerProperties>(queryText))
{
    while (feedIterator.HasMoreResults)
    {
        FeedResponse<ContainerProperties> response = await feedIterator.ReadNextAsync();
        foreach (var container in response)
        {
            Console.WriteLine(container);
        }
    }
}
  1. Isso cria o iterador de feed de tipo para contêineres sem queryText, recuperando todos os contêineres.
using (FeedIterator<ContainerProperties> feedIterator = this.cosmosDatabase.GetContainerQueryIterator<ContainerProperties>())
{
    while (feedIterator.HasMoreResults)
    {
        FeedResponse<ContainerProperties> response = await feedIterator.ReadNextAsync();
        foreach (var container in response)
        {
           Console.WriteLine(container);
        }
    }
}

Comentários

Consulte para https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started obter sintaxe e exemplos.

ReadContainerAsync(ContainerRequestOptions, CancellationToken) é recomendado para pesquisa de contêiner único.

Aplica-se a