セールス: 1-800-867-1380

Query Tables

更新日: 2014年2月

Query Tables 操作は、指定されたアカウントの下位にあるテーブルの一覧を返します。

Query Tables 要求の構成は次のとおりです。HTTPS が推奨されます。myaccount はストレージ アカウントの名前に置き換えます。

 

メソッド 要求 URI HTTP バージョン

GET

https://myaccount.table.core.windows.net/Tables

HTTP/1.1

エミューレートされたストレージ サービスに対する要求では、エミュレーターのホスト名とテーブル サービス ポートを 127.0.0.1:10002 と指定し、その後にエミューレートされたストレージ アカウント名を指定します。

 

メソッド 要求 URI HTTP バージョン

GET

http://127.0.0.1:10002/devstoreaccount1/Tables

HTTP/1.1

エミュレートされたストレージ サービスのテーブル サービスは、Windows® Azure™ のテーブル サービスとはいくつかの点で異なります。詳細については、「About Development Storage」および「ストレージ エミュレーターと Azure ストレージ サービスとの違い」を参照してください。

Query Tables 操作は、OData プロトコル仕様で定義されているクエリ オプションをサポートしています。詳細については、「OData URI 規則」を参照してください。

必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。

 

要求ヘッダー 説明

Authorization

必須。認証スキーム、アカウント名、および署名を指定します。詳細については、「Azure ストレージ サービスの認証」を参照してください。

Date またはx-ms-date

必須。要求の世界協定時刻 (UTC) を指定します。詳細については、「Azure ストレージ サービスの認証」を参照してください。

x-ms-version

省略可能。この要求に使用する操作のバージョンを指定します。詳細については、「Azure ストレージ サービスのバージョン設定」を参照してください。

Accept

省略可能。応答ペイロードの受け入れられたコンテンツの種類を指定します。次の値をとります。

  • application/atom+xml

  • application/json;odata=nometadata

  • application/json;odata=minimalmetadata

  • application/json;odata=fullmetadata

詳細については、「テーブル サービス操作のペイロード形式」を参照してください。

x-ms-client-request-id

省略可能。Storage Analytics Logging が有効な場合に解析ログに記録される、クライアントで生成された非透過の値を 1 KB の文字制限付きで提供します。クライアント側のアクティビティとサーバーが受け取る要求を相互に関連付けるには、このヘッダーを使用することを強くお勧めします。詳細については、「Storage Analytics Logging について」および「Windows Azure のログ: ログを使用した、ストレージ要求の追跡」を参照してください。

なし。

応答には、HTTP 状態コード、一連の応答ヘッダー、および応答本文が含まれています。

操作が正常に終了すると、ステータス コード 200 (OK) が返されます。

ステータス コードの詳細については、「ステータス コードとエラー コード」および「テーブル サービスのエラー コード」を参照してください。

この操作の応答には、次のヘッダーが含まれています。応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。標準ヘッダーはすべて、HTTP/1.1 プロトコル仕様に準拠しています。

 

応答ヘッダー 説明

x-ms-continuation-NextTableName

返されるテーブルの数が 1,000 個を超える場合、またはクエリがタイムアウト間隔内に完了しない場合は、応答ヘッダーに x-ms-continuation-NextTableName 継続ヘッダーが含まれます。このヘッダーは、継続トークンの値を返します。継続トークンの使用方法の詳細については、「クエリのタイムアウトと改ページ」を参照してください。

x-ms-request-id

このヘッダーは要求を一意に識別するので、要求のトラブルシューティングに使用できます。詳細については、「API 操作のトラブルシューティング」を参照してください。

x-ms-version

要求の実行に使用するテーブル サービスのバージョンを示します。このヘッダーはバージョン 2009-09-19 以降で行った要求に対して返されます。

Date

サービスによって生成される、応答の開始時刻を示す UTC 日付/時刻値。

Content-Type

ペイロードのコンテンツの種類を示します。値は、要求 Accept ヘッダーによって異なります。次の値をとります。

  • application/atom+xml

  • application/json;odata=nometadata

  • application/json;odata=minimalmetadata

  • application/json;odata=fullmetadata

有効なコンテンツの種類の詳細については、「テーブル サービス操作のペイロード形式」を参照してください。

Query Tables 操作は、アカウント内のテーブルの一覧を OData エンティティ セットで返します。Accept ヘッダーの値に従って、コンテンツは Atom フィードまたは JSON です。

Atom フィード

次の例は、Query Tables 操作の Atom 応答本文です。

<?xml version="1.0" encoding="utf-8" standalone="yes"?>
<feed xml:base="https://myaccount.table.core.windows.net/" xmlns:d="http://schemas.microsoft.com/ado/2007/08/dataservices" xmlns:m="http://schemas.microsoft.com/ado/2007/08/dataservices/metadata" xmlns="http://www.w3.org/2005/Atom">
  <title type="text">Tables</title>
  <id>https://myaccount.table.core.windows.net/Tables</id>
  <updated>2009-01-04T17:18:54.7062347Z</updated>
  <link rel="self" title="Tables" href="Tables" />
  <entry>
    <id>https://myaccount.table.core.windows.net/Tables('mytable')</id>
    <title type="text"></title>
    <updated>2009-01-04T17:18:54.7062347Z</updated>
    <author>
      <name />
    </author>
    <link rel="edit" title="Tables" href="Tables('mytable')" />
    <category term="myaccount.Tables" scheme="http://schemas.microsoft.com/ado/2007/08/dataservices/scheme" />
    <content type="application/xml">
      <m:properties>
        <d:TableName>mytable</d:TableName>
      </m:properties>
    </content>
  </entry>
</feed> 

JSON

次の例は、Query Tables 操作の JSON 応答本文です。

完全なメタデータ

{
   "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables",
   "value":[
      {
         "odata.type":"myaccount.Tables",
         "odata.id":"https://myaccount.table.core.windows.net/Tables('mytable')",
         "odata.editLink":"Tables('mytable')",
         "TableName":"mytable"
      }
}

最小のメタデータ

{
    "odata.metadata":"https://myaccount.table.core.windows.net/$metadata#Tables",
    "value":[{
        "TableName":"mytable"
    }]
}

メタデータなし

{
   "value":[{
       "TableName":"mytable"
   },
}

この操作を呼び出すことができるのはアカウント所有者のみです。

テーブル サービスに対するクエリは最長 5 秒間実行され、一度に最大 1,000 個のテーブルが返されます。返されるテーブル数が 1,000 個を超える場合、クエリが 5 秒以内に終了しない場合、またはクエリがパーティション境界を超える場合は、x-ms-continuation-NextTableName 継続トークンを含むカスタム ヘッダーが応答に含まれます。この継続トークンを使用して、引き続き次のデータ ページを要求できます。継続トークンの詳細については、「クエリのタイムアウトと改ページ」を参照してください。

クエリのスケジュール設定および処理用として要求に割り当てられる時間は、クエリの実行に要する 5 秒を含め、合計で 30 秒間です。

LINQ を使用してテーブル サービスに対して実行できるクエリ操作の詳細については、「テーブル サービスでサポートされるクエリ演算子」および「テーブル サービスに対する LINQ クエリの作成」を参照してください。

この情報は役に立ちましたか。
(残り 1500 文字)
フィードバックをいただき、ありがとうございました
表示:
© 2014 Microsoft