paging - Freebase “Key cursor is a reserved word”

Question

跟随Freebase docs on Envelope Parameters，运行

{
  "cursor":true,
  "query":[{
    "type":"/music/album",
    "artist":"The Police",
    "name":null,
    "limit":10
  }]
}​

results in error "Key cursor is a reserved word"为 @Domenic notes。

怎么了

编辑1

所以 this query without a cursor works但 this one doesn't是 cursor was a variable name not a string enclosed in quotes。

作为用户，键入 "cursor"的损坏版本是有意义的，因为 the read parameter type table同时将 query和 "cursor"都作为 type: string，并且如果将引号括在 query中，则 "query"会出错

但是，即使将 "cursor"括在引号中仍然不起作用:它会为每个查询生成相同的数据。

Answer 1

看起来这可能是查询编辑器过于智能并无法解决问题的另一种情况。如果将上面的查询复制并粘贴到查询编辑器中，然后按“运行”，则将报告此错误:

{
  "code":          "/api/status/error",
      "messages": [{
    "code":    "/api/status/error/mql/type",
    "info": {
      "expected_type": "/type/object",
      "property":      "cursor"
    },
    "message": "Key cursor is a reserved word",
    "path":    "",
    "query": {
      "cursor":       true,
      "error_inside": ".",
      "query": [{
        "artist": "The Police",
        "limit":  10,
        "name":   null,
        "type":   "/music/album"
      }]
    }
  }],
  "status":        "200 OK",
  "transaction_id": "cache;cache03.p01.sjc1:8101;2011-11-04T17:42:13Z;0057"
}

但是，如果您单击该查询的永久链接，它将更改为该查询，并自动将cursor属性设置为true。

[{
  "type":   "/music/album",
  "artist": "The Police",
  "name":   null,
  "limit":  10
}]​

发生这种情况是因为MQL读取服务希望查询嵌套在 query envelope内，但是查询编辑器只接受您提供的查询，并自动将其包装在适合您的查询信封中。

在新版本的 MQL read service中，我们取消了查询信封​​，现在cursor只是HTTP GET请求上的参数。