Compartilhar via


CosmosClient.GetDatabaseQueryStreamIterator Método

Definição

Sobrecargas

GetDatabaseQueryStreamIterator(QueryDefinition, String, QueryRequestOptions)

Esse método cria uma consulta para bancos de dados em uma conta do Cosmos DB 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.

GetDatabaseQueryStreamIterator(String, String, QueryRequestOptions)

Esse método cria uma consulta para bancos de dados em uma conta do Cosmos DB usando uma instrução SQL. Ele retorna um FeedIterator.

GetDatabaseQueryStreamIterator(QueryDefinition, String, QueryRequestOptions)

Origem:
CosmosClient.cs

Esse método cria uma consulta para bancos de dados em uma conta do Cosmos DB 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.

public virtual Microsoft.Azure.Cosmos.FeedIterator GetDatabaseQueryStreamIterator (Microsoft.Azure.Cosmos.QueryDefinition queryDefinition, string continuationToken = default, Microsoft.Azure.Cosmos.QueryRequestOptions requestOptions = default);
abstract member GetDatabaseQueryStreamIterator : Microsoft.Azure.Cosmos.QueryDefinition * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator
override this.GetDatabaseQueryStreamIterator : Microsoft.Azure.Cosmos.QueryDefinition * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator
Public Overridable Function GetDatabaseQueryStreamIterator (queryDefinition As QueryDefinition, Optional continuationToken As String = Nothing, Optional requestOptions As QueryRequestOptions = Nothing) As FeedIterator

Parâmetros

queryDefinition
QueryDefinition

A definição de consulta DO COSMOS SQL.

continuationToken
String

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

requestOptions
QueryRequestOptions

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

Retornos

Um iterador para percorrer os bancos de dados

Exemplos

Exemplo sobre como esvaziar totalmente os resultados da consulta.

QueryDefinition queryDefinition = new QueryDefinition("select * From c where c._rid = @rid")
              .WithParameter("@rid", "TheRidValue");
using (FeedIterator feedIterator = this.CosmosClient.GetDatabaseQueryStreamIterator(
    queryDefinition)
{
    while (feedIterator.HasMoreResults)
    {
        // Stream iterator returns a response with status for errors
        using(ResponseMessage response = await feedIterator.ReadNextAsync())
        {
            // Handle failure scenario. 
            if(!response.IsSuccessStatusCode)
            {
                // Log the response.Diagnostics and handle the error
            }
        }
    }
}

Comentários

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

ReadStreamAsync(RequestOptions, CancellationToken) é recomendado para pesquisa de banco de dados único.

Aplica-se a

GetDatabaseQueryStreamIterator(String, String, QueryRequestOptions)

Origem:
CosmosClient.cs

Esse método cria uma consulta para bancos de dados em uma conta do Cosmos DB usando uma instrução SQL. Ele retorna um FeedIterator.

public virtual Microsoft.Azure.Cosmos.FeedIterator GetDatabaseQueryStreamIterator (string queryText = default, string continuationToken = default, Microsoft.Azure.Cosmos.QueryRequestOptions requestOptions = default);
abstract member GetDatabaseQueryStreamIterator : string * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator
override this.GetDatabaseQueryStreamIterator : string * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator
Public Overridable Function GetDatabaseQueryStreamIterator (Optional queryText As String = Nothing, Optional continuationToken As String = Nothing, Optional requestOptions As QueryRequestOptions = Nothing) As FeedIterator

Parâmetros

queryText
String

O texto da consulta DO COSMOS SQL.

continuationToken
String

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

requestOptions
QueryRequestOptions

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

Retornos

Um iterador para percorrer os bancos de dados

Exemplos

Exemplo sobre como esvaziar totalmente os resultados da consulta.

using (FeedIterator feedIterator = this.CosmosClient.GetDatabaseQueryStreamIterator(
    ("select * From c where c._rid = 'TheRidValue'")
{
    while (feedIterator.HasMoreResults)
    {
        // Stream iterator returns a response with status for errors
        using(ResponseMessage response = await feedIterator.ReadNextAsync())
        {
            // Handle failure scenario. 
            if(!response.IsSuccessStatusCode)
            {
                // Log the response.Diagnostics and handle the error
            }
        }
    }
}

Comentários

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

ReadStreamAsync(RequestOptions, CancellationToken) é recomendado para pesquisa de banco de dados único.

Aplica-se a