你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

CosmosClient.GetDatabaseQueryIterator 方法

定义

命名空间:

Microsoft.Azure.Cosmos

程序集:

Microsoft.Azure.Cosmos.Client.dll

包:

Microsoft.Azure.Cosmos v3.39.0

重载

GetDatabaseQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)	此方法使用具有参数化值的 SQL 语句为 Cosmos DB 帐户下的数据库创建查询。 它返回 FeedIterator。 有关使用参数化值准备 SQL 语句的详细信息，请参阅 QueryDefinition。
GetDatabaseQueryIterator<T>(String, String, QueryRequestOptions)	此方法使用 SQL 语句为 Cosmos DB 帐户下的数据库创建查询。 它返回 FeedIterator。

GetDatabaseQueryIterator<T>(QueryDefinition, String, QueryRequestOptions)

Source:

CosmosClient.cs

此方法使用具有参数化值的 SQL 语句为 Cosmos DB 帐户下的数据库创建查询。 它返回 FeedIterator。 有关使用参数化值准备 SQL 语句的详细信息，请参阅 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)

类型参数

T

参数

queryDefinition

QueryDefinition

cosmos SQL 查询定义。

continuationToken

String

Azure Cosmos DB 服务中的延续令牌。

requestOptions

QueryRequestOptions

(可选) 项查询请求的选项。

返回

FeedIterator<T>

用于遍历数据库的迭代器。

示例

这将为数据库创建类型源迭代器，并将 queryText 作为输入，

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

注解

有关语法和示例， https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started 请参阅 。

ReadAsync(RequestOptions, CancellationToken) 建议用于单一数据库查找。

GetDatabaseQueryIterator<T>(String, String, QueryRequestOptions)

Source:

CosmosClient.cs

此方法使用 SQL 语句为 Cosmos DB 帐户下的数据库创建查询。 它返回 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)

类型参数

T

参数

queryText

String

cosmos SQL 查询文本。

continuationToken

String

Azure Cosmos DB 服务中的延续令牌。

requestOptions

QueryRequestOptions

(可选) 项查询请求的选项。

返回

FeedIterator<T>

用于遍历数据库的迭代器。

示例

这将为数据库创建类型源迭代器，并将 queryText 作为输入，

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

注解

有关语法和示例， https://docs.microsoft.com/azure/cosmos-db/sql-query-getting-started 请参阅 。

ReadAsync(RequestOptions, CancellationToken) 建议用于单一数据库查找。