DocumentDB - 限制记录
Microsoft 最近针对如何查询 Azure DocumentDB 添加了许多改进,例如 SQL 语法中的 TOP 关键字,这使得查询运行得更快,消耗的资源更少,增加了查询运算符的限制,并增加了对 .NET SDK 中其他 LINQ 运算符的支持。
让我们看一个简单的示例,其中我们将仅检索前两条记录。 如果您有许多记录并且只想检索其中的某些记录,则可以使用 Top 关键字。 在此示例中,我们有很多earthquake(地震)记录。
现在我们只想显示前两条记录
步骤 1 − 转到查询资源管理器并运行此查询。
SELECT * FROM c WHERE c.magnitude > 2.5
您将看到它已检索到 4 条记录,因为我们尚未指定 TOP 关键字。
步骤 2 − 现在使用 TOP 关键字进行相同的查询。 这里我们指定了 TOP 关键字,"2"表示我们只需要两条记录。
SELECT TOP 2 * FROM c WHERE c.magnitude > 2.5
步骤 3 − 现在运行此查询,您将看到仅检索到两条记录。
同样,您可以在使用 .Net SDK 的代码中使用 TOP 关键字。 下面是实现。
private async static Task QueryDocumentsWithPaging(DocumentClient client) { Console.WriteLine(); Console.WriteLine("**** Query Documents (paged results) ****"); Console.WriteLine(); Console.WriteLine("Quering for all documents"); var sql = "SELECT TOP 3 * FROM c"; var query = client .CreateDocumentQuery(collection.SelfLink, sql) .AsDocumentQuery(); while (query.HasMoreResults) { var documents = await query.ExecuteNextAsync(); foreach (var document in documents) { Console.WriteLine(" PublicId: {0}; Magnitude: {1};", document.publicid, document.magnitude); } } Console.WriteLine(); }
下面是CreateDocumentClient任务,其中实例化了DocumentClient和earthquake(地震)数据库。
private static async Task CreateDocumentClient() { // Create a new instance of the DocumentClient using (var client = new DocumentClient(new Uri(EndpointUrl), AuthorizationKey)) { database = client.CreateDatabaseQuery("SELECT * FROM c WHERE c.id = 'earthquake'").AsEnumerable().First(); collection = client.CreateDocumentCollectionQuery(database.CollectionsLink, "SELECT * FROM c WHERE c.id = 'earthquakedata'").AsEnumerable().First(); await QueryDocumentsWithPaging(client); } }
当上面的代码编译并执行时,你会看到只检索到了3条记录。
**** Query Documents (paged results) **** Quering for all documents PublicId: 2015p947400; Magnitude: 2.515176918; PublicId: 2015p947373; Magnitude: 1.506774108; PublicId: 2015p947329; Magnitude: 1.593394461;