このページは役に立ちましたか。
このページのコンテンツについての ご意見をお待ちしております
その他にご意見はありますか。
残り 1500 文字
テーブル デザイナー用のフィルター文字列の作成

テーブル デザイナー用のフィルター文字列の作成

更新日: 2015年5月

Visual Studio テーブル デザイナーに表示される Azure テーブルのデータをフィルター処理するには、フィルター文字列を作成し、フィルター フィールドに入力します。フィルター文字列の構文は、WCF Data Services で定義されており、SQL の WHERE 句に似ています。ただし、文字列は HTTP 要求を介してテーブル サービスに送信されます。テーブル デザイナーでは、適切にエンコードが処理されます。したがって、目的のプロパティ値をフィルター処理するには、フィルター フィールドに、プロパティ名、比較演算子、条件値、およびブール演算子 (省略可能) を入力するだけで済みます。「ストレージ サービス REST API リファレンス」を使用してテーブルに問い合わせる URL を作成する場合のように、$filter クエリ オプションを含める必要はありません。

WCF Data Services は、Open Data Protocol (OData) に基づいています。フィルター システム クエリ オプション ($filter) の詳細については、「OData URI 規則仕様 (このページは英語の場合があります)」を参照してください。

次の論理演算子は、すべてのプロパティ型でサポートされています。

 

論理演算子 説明 フィルター文字列の例

eq

Equal

City eq 'Redmond'

gt

より大きい

Price gt 20

ge

以上

Price ge 10

lt

より小さい

Price lt 20

le

Less than or equal

Price le 100

ne

Not equal

City ne 'London'

And

Price le 200 and Price gt 3.5

または

または

Price le 3.5 or Price gt 200

Not

not isAvailable

フィルター文字列を作成するときは、次の規則が重要です。

  • プロパティを値と比較するには、論理演算子を使用します。プロパティを動的な値と比較することはできません。式の 1 つの辺は定数である必要があります。

  • フィルター文字列のすべての部分で大文字と小文字が区別されます。

  • フィルターが有効な結果を返すようにするには、定数値のデータ型をプロパティと同じデータ型にする必要があります。サポートされているプロパティ型の詳細については、「テーブル サービス データ モデルについて」を参照してください。

文字列プロパティのフィルター処理

文字列プロパティをフィルター処理する場合は、文字列定数を単一引用符で囲みます。

次の例では、PartitionKey プロパティおよび RowKey プロパティをフィルター処理しています。キー以外のプロパティをフィルター文字列に追加することもできます。

PartitionKey eq 'Partition1' and RowKey eq '00001'

各フィルター式をかっこで囲むことができます。ただし、これは必須ではありません。

(PartitionKey eq 'Partition1') and (RowKey eq '00001')

ワイルドカードによるクエリは、テーブル サービスでも、テーブル デザイナーでもサポートされていません。ただし、目的のプレフィックスに対して比較演算子を使用することで、プレフィックス一致を実行できます。次の例は、文字 'A' で始まる LastName プロパティを持つエンティティを返します。

LastName ge 'A' and LastName lt 'B'

数値プロパティのフィルター処理

整数または浮動小数点数をフィルター処理するには、引用符なしで数値を指定します。

次の例は、値が 30 より大きい Age プロパティを持つすべてのエンティティを返します。

Age gt 30

次の例は、値が 100.25 以下の AmountDue プロパティを持つすべてのエンティティを返します。

AmountDue le 100.25

ブール型プロパティのフィルター処理

ブール値をフィルター処理するには、引用符なしで true または false を指定します。

次の例は、IsActive プロパティが true に設定されているすべてのエンティティを返します。

IsActive eq true

このフィルター式は、論理演算子なしで記述することもできます。次の例でも、テーブル サービスは IsActive が true であるすべてのエンティティを返します。

IsActive

IsActive が false であるすべてのエンティティを返すには、not 演算子を使用します。

not IsActive

DateTime プロパティのフィルター処理

DateTime 値をフィルター処理するには、datetime キーワードを指定し、その後に単一引用符で囲んだ日付/時刻の定数を指定します。日付/時刻の定数は、結合 UTC 形式にする必要があります。詳細については、「DateTime プロパティ値の書式設定」を参照してください。

次の例は、CustomerSince プロパティが 2008 年 7 月 10 日と等しいエンティティを返します。

CustomerSince eq datetime'2008-07-10T00:00:00Z'

表示:
© 2015 Microsoft