CosmosClient.GetDatabaseQueryIterator Methode

Definition

Namespace:

Microsoft.Azure.Cosmos

Assembly:

Microsoft.Azure.Cosmos.Client.dll

Paket:

Microsoft.Azure.Cosmos v3.39.0

Überlädt

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

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

Typparameter

T

Parameter

queryDefinition

QueryDefinition

Die Cosmos SQL-Abfragedefinition.

continuationToken

String

Das Fortsetzungstoken im Azure Cosmos DB-Dienst.

requestOptions

QueryRequestOptions

(Optional) Die Optionen für die Elementabfrageanforderung.

Gibt zurück

FeedIterator<T>

Ein Iterator zum Durchlaufen der Datenbanken.

Beispiele

Dadurch wird der Typfeediterator für die Datenbank mit queryText als Eingabe erstellt.

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

Hinweise

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

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

GetDatabaseQueryIterator<T>(String, String, QueryRequestOptions)

Quelle:

CosmosClient.cs

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

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)

Typparameter

T

Parameter

queryText

String

Der Cosmos SQL-Abfragetext.

continuationToken

String

Das Fortsetzungstoken im Azure Cosmos DB-Dienst.

requestOptions

QueryRequestOptions

(Optional) Die Optionen für die Elementabfrageanforderung.

Gibt zurück

FeedIterator<T>

Ein Iterator zum Durchlaufen der Datenbanken.

Beispiele

Dadurch wird der Typfeediterator für die Datenbank mit queryText als Eingabe erstellt.

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

Hinweise

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

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