CosmosClient.GetDatabaseQueryIterator Método

Definição

Namespace:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Pacote:

Microsoft.Azure.Cosmos v3.39.0

Sobrecargas

GetDatabaseQueryIterator<T>(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.
GetDatabaseQueryIterator<T>(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.

GetDatabaseQueryIterator<T>(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<T> GetDatabaseQueryIterator<T> (Microsoft.Azure.Cosmos.QueryDefinition queryDefinition, string continuationToken = default, Microsoft.Azure.Cosmos.QueryRequestOptions requestOptions = default);

abstract member GetDatabaseQueryIterator : Microsoft.Azure.Cosmos.QueryDefinition * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator<'T>
override this.GetDatabaseQueryIterator : Microsoft.Azure.Cosmos.QueryDefinition * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator<'T>

Public Overridable Function GetDatabaseQueryIterator(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 cosmos.

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 de item.

Retornos

FeedIterator<T>

Um iterador para percorrer os bancos de dados.

Exemplos

Isso cria o iterador de feed de tipo para o banco de dados com queryText como entrada,

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

Comentários

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

ReadAsync(RequestOptions, CancellationToken) é recomendado para pesquisa de banco de dados individual.

GetDatabaseQueryIterator<T>(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<T> GetDatabaseQueryIterator<T> (string queryText = default, string continuationToken = default, Microsoft.Azure.Cosmos.QueryRequestOptions requestOptions = default);

abstract member GetDatabaseQueryIterator : string * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator<'T>
override this.GetDatabaseQueryIterator : string * string * Microsoft.Azure.Cosmos.QueryRequestOptions -> Microsoft.Azure.Cosmos.FeedIterator<'T>

Public Overridable Function GetDatabaseQueryIterator(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 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 de item.

Retornos

FeedIterator<T>

Um iterador para percorrer os bancos de dados.

Exemplos

Isso cria o iterador de feed de tipo para o banco de dados com queryText como entrada,

string queryText = "SELECT * FROM c where c.status like 'start%'";
using (FeedIterator<DatabaseProperties> feedIterator = this.users.GetDatabaseQueryIterator<DatabaseProperties>(queryText)
{
    while (feedIterator.HasMoreResults)
    {
        FeedResponse<DatabaseProperties> response = await feedIterator.ReadNextAsync();
        foreach (var database in response)
        {
            Console.WriteLine(database);
        }
    }
}

Comentários

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

ReadAsync(RequestOptions, CancellationToken) é recomendado para pesquisa de banco de dados individual.