承認済みビューの概要
Bigtable テーブルの承認済みビューを使用すると、Bigtable データに対するきめ細かなアクセス制御が可能です。承認済みビューは、特定のテーブルデータを含むように構成するテーブルのサブセットです。次に、テーブルへのアクセス権とは別に承認済みビューへのアクセス権を付与します。
承認済みビューは、マルチテナント テーブルや、すべてのユーザーがアクセスできるわけではないデータがテーブルに含まれているその他のシチュエーションで役立ちます。他のデータベース サービスのビューとは異なり、Bigtable 承認済みビューは読み取りと書き込みの両方のアクセス権を制御するために使用できます。他のストレージ システムが「更新可能なビュー」または「フィルタされたエイリアス」と呼ばれるものと同じ方法で、何千もの承認済みビューをプログラムで作成できます。
このドキュメントでは、承認済みビューについて説明し、定義ファイルの例を示します。このドキュメントを読む前に、Bigtable ストレージ モデルを理解しておく必要があります。手順については、承認済みビューを作成して管理するをご覧ください。
承認済みビューの定義
承認済みビューを作成する場合は、次のいずれかのパラメータを使用して承認済みビューに含めるデータを指定することでビューを定義します。
- 行キーの接頭辞 -
examplepetstore1|で始まるすべての行など - 列修飾子の接頭辞 - 指定された列ファミリー内の、修飾子が
order#で始まるすべての列など - 列修飾子 - 指定された列ファミリー内の
order-examplepetstore列のみなど - 行キー接頭辞と列修飾子を組み合わせたもの
複数の列ファミリーで同じ列修飾子が使用されており、その修飾子を持つすべての列をビューに含める場合は、ビューを定義するときに列修飾子と列ファミリーのすべての組み合わせを個別に指定する必要があります。
承認済みビューの定義に使用する行キーと列修飾子の値は、サービスデータとして扱われます。このため、機密情報を含む行キーまたは列修飾子の値を使用して、承認済みビューを作成しないでください。サービスデータが取り扱われる方法については、Google Cloud のプライバシーに関するお知らせをご覧ください。
ファミリーまたはすべての行に列を含める
基になるテーブルの列ファミリーに追加した列が承認済みビューにも含まれるようにするには、空の文字列（""）を列修飾子の接頭辞として指定する必要があります。たとえば、定義ファイルには、ファミリー サブセットに "qualifierPrefixes": [""] が含まれます。
同様に、テーブルのすべての行を含む承認済みビューを定義する場合は、行キーの接頭辞として空の文字列（""）を指定します。定義ファイルでは、ビューのサブセットで "rowPrefixes": [""] と記述されます。
承認済みビューが過度に複雑になるのを防ぐため、Bigtable では最大 10 個の異なる修飾子接頭辞を指定できます。つまり、承認済みビューでは、10 個の修飾子接頭辞を持つ 1 つの列ファミリー、1 つの修飾子接頭辞を持つ 10 個の列ファミリー、または修飾子の合計数が 10 個以下であれば、その間の任意の数を指定できます。
ベスト プラクティスとして、JSON オブジェクトごとにキーを 1 回だけ指定します。列ファミリー名などのキーを複数回指定すると、キーの最後のエントリによって、キーの以前のエントリが上書きされます。
定義ファイルの例
このセクションでは、承認済みビュー定義ファイルの JSON 形式の例を示します。
以下は、承認済みビューの定義ファイルの例です。この承認済みビューには、行キー接頭辞が examplepetstore1# である行の customer 列ファミリーの address 列と、tel で始まる列が含まれます。
{
"subsetView":
{
"rowPrefixes": ["examplepetstore1#"],
"familySubsets":
{
"customer":
{
"qualifiers":["address"],
"qualifierPrefixes":["tel"]
}
}
},
"deletionProtection": true
}
以下は、order 列ファミリーの skus 列と customer 列ファミリーのすべての列を含む承認済みビューの定義ファイルの例です。
{
"subsetView": {
"rowPrefixes": [""],
"familySubsets": {
"order": {
"qualifiers": ["skus"]
},
"customer": {
"qualifierPrefixes": [""]
}
}
}
}
以下は、承認済みビューの定義ファイルの例です。この承認済みビューには、行キー接頭辞が examplepetstore1# である行内の order 列ファミリーの skus 列のデータのみを含みます。
{
"subsetView": {
"rowPrefixes": ["examplepetstore1#"]
"familySubsets": {
"order": {
"qualifiers": ["skus"]
}
}
}
}
以下は、承認済みビューの定義ファイルの例です。この承認済みビューには、order 列ファミリーの skus 列と agents 列のデータ、pet_id 列ファミリーの dog 列、cat 列、bird 列のデータのみが含まれます。
{
"subsetView": {
"rowPrefixes": [""]
"familySubsets": {
"order": {
"qualifiers": ["skus", "agents"]
"pet_id": {
"qualifiers": ["dog", "cat", "bird"]
}
}
}
}
}