カスタム レポートの管理

注:

このサービスは現在、限られた一連のクライアントと Microsoft の従業員のみが利用できます。

Xandr 管理者は、このレポートを使用して、内部レポート クラスターに対してカスタム クエリを実行できます。 大量のクエリを実行しないように注意してください。

REST API

HTTP メソッド	エンドポイント	説明
POST	https://api.com/report (レポート JSON)	レポートを取得する

注:

完全な手順については、次の 例 を参照してください。

JSON フィールド

フィールド	種類	説明
report_type	列挙	レポートの種類。 使用可能な値: "admin_backdoor"。 必須:POST
sql	string	SQL クエリ。 where 句/日付範囲をフィルターとして指定し、必要なフィールドのみを選択してください。以下の 例 を参照してください。 必須:POST
hostname	列挙	データベースの名前。 指定できる値: "vt_jayz_internal" (Vertica Jayz)。 必須:POST

例

1. JSON 形式のレポート要求を作成する

   $ cat admin_custom_report
                  {
                  "report": {
                  "report_type": "admin_backdoor",
                  "sql": "select * from agg_dw_intermediate_analytics_adjusted where ymdh >= '2011-10-20 09:04:00' limit 5",
                  "hostname": "vt_jayz_internal"
                  }
                  }
   

2. POST レポート サービスへの要求

   $ curl -b cookies -c cookies -X POST -d @admin_custom_report 'https://api..com/report'
                  {
                  "response": {
                  "status": "OK",
                  "report_id": "f83b50a62b9c2ba2b204ab073b4b8efb",
                  "dbg_info": {
                  "instance": "16.hbapi.prod.nym1",
                  "s1ave_hit": false,
                  "db": "master",
                  "reads": 0,
                  "read_limit": 100,
                  "read_limit_seconds": 60,
                  "writes": 2,
                  "write_limit": 60,
                  "write_limit_seconds": 60,
                  "time": 331.21299743652,
                  "start_microtime": 1323192961.6681,
                  "version": "1.10.28.2",
                  "master_instance": "01.hbapi.sand-08.lax1",
                  "proxy": true,
                  "master_time": 128.6518573761
                  }
                  }
                  }
   

3. レポート ID を使用してレポート データを取得する

   標準応答には、レポート データと、データをファイルに保存できるダウンロード URL が含まれています。 レポート データを含まないダウンロード URL のみを取得する場合は、クエリ文字列を渡します "without_data" 。

   $ curl -b cookies -c cookies 'https://api.appnexus.com/report?id=f83b50a62b9c2ba2b204ab073b4b8efb'
                  {
                  "response": {
                  "status": "OK",
                  "report": {
                  "name": null,
                  "created_on": "2011-12-06 20:50:17",
                  "cache_hit": false,
                  "fact_cache_hit": false,
                  "fact_cache_error": "empty used fields",
                  "json_request": "{\"report\":{\"report_type\":\"admin_backdoor\",\"sql\":\"select * from
                  agg_dw_intermediate_analytics_adjusted where ymdh >= '2011-10-20 09:04:00' limit 5\",
                  \"hostname\":\"vt_jayz_internal\"}}",
                  "header_info": "Report type:,admin_backdoor\u000d\u000a,\u000d\u000aRun at:,2011-12-06 20:50:17
                  \u000d\u000aStart date:,\u000d\u000aEnd date:,\u000d\u000aTimezone:,\u000d\u000aUser:,
                  John Smith (9685)\u000d\u000a",
                  "data": "/mnt/isilon/reports/20111206/a4a937b4-6151-4678-ac65-0ab1f3790ae3",
                  "url": "report-download?id=f83b50a62b9c2ba2b204ab073b4b8efb"
                  },
                  "execution_status": "ready",
                  "dbg_info": {
                  "instance": "16.hbapi.prod.nym1",
                  "s1ave_hit": false,
                  "db": "master",
                  "reads": 1,
                  "read_limit": 100,
                  "read_limit_seconds": 60,
                  "writes": 0,
                  "write_limit": 60,
                  "write_limit_seconds": 60,
                  "time": 95.331907272339,
                  "start_microtime": 1323205122.5099,
                  "version": "1.10.27"
                  }
                  }
                  }
   

4. ダウンロード URL を使用してレポート データをファイルに保存する

   応答の フィールドを "url" 使用して、レポート データをファイルに保存します。 別の GET 呼び出しを行い、保存する場所とファイルを特定するだけです。 最初POSTの要求で指定した の"format"拡張子を持つファイルを必ず使用してください。

   $ curl -b cookies -c cookies 'https://api.appnexus.com/report-download?id=495d03a7667bac467bb488043ae336e9' > /tmp/admin_report.csv