CosmosClient.GetDatabaseQueryStreamIterator Methode

Definition

Namespace:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paket:

Microsoft.Azure.Cosmos v3.39.0

Überlädt

GetDatabaseQueryStreamIterator(QueryDefinition, String, QueryRequestOptions)	Diese Methode erstellt eine Abfrage für Datenbanken unter einem Cosmos DB-Konto mithilfe einer SQL-Anweisung mit parametrisierten Werten. Es gibt einen FeedIterator zurück. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter QueryDefinition.
GetDatabaseQueryStreamIterator(String, String, QueryRequestOptions)	Diese Methode erstellt eine Abfrage für Datenbanken unter einem Cosmos DB-Konto mithilfe einer SQL-Anweisung. Es gibt einen FeedIterator zurück.

GetDatabaseQueryStreamIterator(QueryDefinition, String, QueryRequestOptions)

Quelle:

CosmosClient.cs

Diese Methode erstellt eine Abfrage für Datenbanken unter einem Cosmos DB-Konto mithilfe einer SQL-Anweisung mit parametrisierten Werten. Es gibt einen FeedIterator zurück. Weitere Informationen zum Vorbereiten von SQL-Anweisungen mit parametrisierten Werten finden Sie unter 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

Parameter

queryDefinition

QueryDefinition

Die Cosmos SQL-Abfragedefinition.

continuationToken

String

Das Fortsetzungstoken im Azure Cosmos DB-Dienst.

requestOptions

QueryRequestOptions

(Optional) Die Optionen für die Abfrageanforderung.

Gibt zurück

FeedIterator

Ein Iterator zum Durchlaufen der Datenbanken

Beispiele

Beispiel für die vollständige Entwässerung der Abfrageergebnisse.

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

Hinweise

Syntax und Beispiele finden Sie unter https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started .

ReadStreamAsync(RequestOptions, CancellationToken) wird für die Einzeldatenbanksuche empfohlen.

GetDatabaseQueryStreamIterator(String, String, QueryRequestOptions)

Quelle:

CosmosClient.cs

Diese Methode erstellt eine Abfrage für Datenbanken unter einem Cosmos DB-Konto mithilfe einer SQL-Anweisung. Es gibt einen FeedIterator zurück.

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

Parameter

queryText

String

Der Cosmos SQL-Abfragetext.

continuationToken

String

Das Fortsetzungstoken im Azure Cosmos DB-Dienst.

requestOptions

QueryRequestOptions

(Optional) Die Optionen für die Abfrageanforderung.

Gibt zurück

FeedIterator

Ein Iterator zum Durchlaufen der Datenbanken

Beispiele

Beispiel für die vollständige Entwässerung der Abfrageergebnisse.

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

Hinweise

Syntax und Beispiele finden Sie unter https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started .

ReadStreamAsync(RequestOptions, CancellationToken) wird für die Einzeldatenbanksuche empfohlen.