Partager via

CosmosClient.GetDatabaseQueryStreamIterator Méthode

  • Référence

Définition

Espace de noms:
Microsoft.Azure.Cosmos
Assembly:
Microsoft.Azure.Cosmos.Client.dll
Paquet:
Microsoft.Azure.Cosmos v3.39.0

Surcharges

GetDatabaseQueryStreamIterator(QueryDefinition, String, QueryRequestOptions)

Cette méthode crée une requête pour les bases de données sous un compte Cosmos DB à l’aide d’une instruction SQL avec des valeurs paramétrables. Il retourne un FeedIterator. Pour plus d’informations sur la préparation d’instructions SQL avec des valeurs paramétrables, consultez QueryDefinition.
GetDatabaseQueryStreamIterator(String, String, QueryRequestOptions)

Cette méthode crée une requête pour les bases de données sous un compte Cosmos DB à l’aide d’une instruction SQL. Il retourne un FeedIterator.

GetDatabaseQueryStreamIterator(QueryDefinition, String, QueryRequestOptions)

Source:
CosmosClient.cs

Cette méthode crée une requête pour les bases de données sous un compte Cosmos DB à l’aide d’une instruction SQL avec des valeurs paramétrables. Il retourne un FeedIterator. Pour plus d’informations sur la préparation d’instructions SQL avec des valeurs paramétrables, consultez 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

Paramètres

queryDefinition
QueryDefinition

Définition de requête cosmos SQL.

continuationToken
String

Jeton de continuation dans le service Azure Cosmos DB.

requestOptions
QueryRequestOptions

(Facultatif) Options de la requête.

Retours

FeedIterator

Itérateur pour parcourir les bases de données

Exemples

Exemple sur la façon de vider complètement les résultats de la requête.

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
            }
        }
    }
}

Remarques

Reportez-vous à pour obtenir la https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started syntaxe et des exemples.

ReadStreamAsync(RequestOptions, CancellationToken) est recommandé pour la recherche d’une base de données unique.

S’applique à

GetDatabaseQueryStreamIterator(String, String, QueryRequestOptions)

Source:
CosmosClient.cs

Cette méthode crée une requête pour les bases de données sous un compte Cosmos DB à l’aide d’une instruction SQL. Il retourne un 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

Paramètres

queryText
String

Texte de la requête cosmos SQL.

continuationToken
String

Jeton de continuation dans le service Azure Cosmos DB.

requestOptions
QueryRequestOptions

(Facultatif) Options de la requête.

Retours

FeedIterator

Itérateur pour parcourir les bases de données

Exemples

Exemple sur la façon de vider complètement les résultats de la requête.

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
            }
        }
    }
}

Remarques

Reportez-vous à pour obtenir la https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started syntaxe et des exemples.

ReadStreamAsync(RequestOptions, CancellationToken) est recommandé pour la recherche d’une base de données unique.

S’applique à