リソースに割り当てられたタグの管理に関する要件 LF タグをテーブル列に割り当てる LF タグをデータカタログリソースに割り当てるリソースの LF タグの更新リソースからの LF タグの削除

Data Catalog リソースへの LF タグの割り当て

LF タグを Data Catalog リソース (データベース、テーブル、および列) に割り当てて、それらのリソースへのアクセスを制御できます。リソースにアクセスできるのは、一致する LF タグが付与されたプリンシパル (および名前付きリソース方式でアクセス権が付与されたプリンシパル) のみです。

テーブルがデータベースから LF タグを継承する場合、または列がテーブルからLF タグを継承する場合は、LF タグのキーに新しい値を割り当てることで、継承された値を上書きできます。

リソースに割り当てることができる LF タグの最大数は 50 個です。

リソースに割り当てられたタグの管理に関する要件

LF タグを Data Catalog リソースに割り当てるには、以下の要件を満たす必要があります。

LF タグに対する Lake Formation の ASSOCIATE 許可がある。
IAM lakeformation:AddLFTagsToResource の許可がある。
Glue データベースに対する glue: GetDatabase 許可を持っている。
リソース所有者 (作成者) である、リソースに対する GRANT オプション付きの Super Lake Formation 許可を持っている、または GRANT オプション付きの以下の許可を持っている。
- 同じ AWS アカウント内のデータベースの場合: DESCRIBE、CREATE_TABLE、ALTER、および DROP
- 外部アカウント内のデータベースの場合: DESCRIBE、CREATE_TABLE、および ALTER
- テーブル (および列) の場合: DESCRIBE、ALTER、DROP、INSERT、SELECT、および DELETE

さらに、LF タグと、それが割り当てられるリソースは、同じ AWS アカウントにある必要があります。

データカタログリソースから LF タグを削除するには、これらの要件を満たすとともに、lakeformation:RemoveLFTagsFromResource IAM アクセス許可も持っている必要があります。

LF タグをテーブル列に割り当てる

LF タグをテーブル列に割り当てるには (コンソール)

Lake Formation コンソール (‭‬https://console.aws.amazon.com/lakeformation/‬)を開きます。

上記の要件を満たすユーザーとしてサインインします。
ナビゲーションペインで [Table] (テーブル) を選択します。
テーブル名を選択します (テーブル名の横にあるオプションボタンではありません)。
テーブルの詳細ページの [Schema] (スキーマ) セクションで、[Edit schema] (スキーマを編集) を選択します。
[Edit Schema] (スキーマの編集) ページで、1 つ、または複数の列を選択してから、[Edit tags] (タグを編集) を選択します。

注記
列を追加または削除して、新しいバージョンを保存する予定の場合は、最初にそれらを実行してください。その後、LF タグを編集します。

[LF タグの編集] ダイアログボックスが表示され、テーブルから継承された LF タグが表示されます。
(オプション) [Inherited keys] (継承されたキー) フィールドの横にある[Values](値) リストで、継承された値を上書きする値を選択します。
(オプション) [Assign new LF-Tag] (新しい LF タグを割り当てる) を選択します。その後、[Assigned keys] (割り当てられたキー) でキーを選択し、[Values] (値) でキーの値を選択します。
(オプション) [新しい LF タグを割り当てる] を再度選択して、別の LF タグを追加します。
[Save] (保存) を選択します。

LF タグをデータカタログリソースに割り当てる

Console

LF タグをデータカタログデータベースまたはテーブルに割り当てるには

Lake Formation コンソール (‭‬https://console.aws.amazon.com/lakeformation/‬)を開きます。

前述の要件を満たすユーザーとしてサインインします。
ナビゲーションペインの [Data catalog] で、以下のいずれかを実行します。
- LF タグをデータベースに割り当てるには、[データベース] を選択します。
- LF タグをテーブルに割り当てるには、[テーブル] を選択します。
データベースまたはテーブルを選択し、[Actions] (アクション) メニューで [Edit tags] (タグを編集) を選択します。

[Edit LF-Tags: resource-name] (LF タグの編集: リソース名) ダイアログボックスが表示されます。

テーブルが格納先のデータベースから LF タグを継承した場合、継承された LF タグがウィンドウに表示されます。それ以外の場合は、「There are no inherited LF-Tags associated with the resource.」(このリソースに、継承された LF タグは関連付けられていません。) というテキストが表示されます。
(オプション) テーブルに継承された LF タグがある場合、[継承されたキー] フィールドの横の [値] リストで、継承された値をオーバーライドする値を選択することができます。
新しい LF タグを割り当てるには、以下の手順を実行します。
1. [Assign new LF-Tag] (新しい LF タグを割り当てる) を選択します。
2. [割り当てられたキー] フィールドで LF タグのキーを選択し、[値] フィールドで値を選択します。
3. (オプション) [新しい LF タグを割り当てる] を再度選択して、追加の LF タグを割り当てます。
[Save] (保存) を選択します。

AWS CLI

LF タグをデータカタログリソースに割り当てるには

add-lf-tags-to-resource コマンドを実行します。

次の例は、LF タグ module=orders をデータベース erp 内のテーブル orders に割り当てます。これは、--lf-tags 引数にショートカット構文を使用しています。--lf-tags の CatalogID プロパティはオプションです。指定されない場合は、リソース (この場合はテーブル) のカタログ ID が使用されます。
```
aws lakeformation add-lf-tags-to-resource --resource '{ "Table": {"DatabaseName":"erp", "Name":"orders"}}' --lf-tags  CatalogId=111122223333,TagKey=module,TagValues=orders
```
以下は、コマンドが成功した場合の出力です。
```
{
    "Failures": []
}
```
次の例は、2 つの LF タグを sales テーブルに割り当てて、--lf-tags 引数に JSON 構文を使用します。
```
aws lakeformation add-lf-tags-to-resource --resource '{ "Table": {"DatabaseName":"erp", "Name":"sales"}}' --lf-tags '[{"TagKey": "module","TagValues": ["sales"]},{"TagKey": "environment","TagValues": ["development"]}]'
```
次の例は、LF タグ level=director をテーブル sales の total 列に割り当てます。
```
aws lakeformation add-lf-tags-to-resource --resource '{ "TableWithColumns": {"DatabaseName":"erp", "Name":"sales", "ColumnNames":["total"]}}' --lf-tags TagKey=level,TagValues=director
```

リソースの LF タグの更新

データカタログリソースの LF タグを更新するには (AWS CLI)

前の手順で説明したように、add-lf-tags-to-resource コマンドを使用します。

既存の LF タグと同じキーを持つが、値は異なるという LF タグを追加すると、既存の値が更新されます。

リソースからの LF タグの削除

データカタログリソースの LF タグを削除するには (AWS CLI)

remove-lf-tags-from-resource コマンドを実行します。

親データベースから継承された値をオーバーライドする LF タグの値がテーブルにある場合、テーブルからその LF タグを削除すると、継承された値が復元されます。この動作は、テーブルから継承されたキーの値を上書きする列にも該当します。

以下の例は、sales のテーブルの total の列から LF タグ level=director を削除します。--lf-tags の CatalogID プロパティはオプションです。指定されない場合は、リソース (この場合はテーブル) のカタログ ID が使用されます。
```
aws lakeformation remove-lf-tags-from-resource 
--resource ' { "TableWithColumns":  
{ "DatabaseName": "erp",  "Name": "sales",  "ColumnNames":[ "total"]}}' 
--lf-tags  CatalogId=111122223333,TagKey=level,TagValues=director
```

ブラウザで JavaScript が無効になっているか、使用できません。

AWS ドキュメントを使用するには、JavaScript を有効にする必要があります。手順については、使用するブラウザのヘルプページを参照してください。

ドキュメントの表記規則

LF タグのリスト化

リソースに割り当てられた LF タグの表示