Boto3を使ってAWS Glueデータカタログから特定のバージョンのテーブルを削除する方法

はじめに

本記事では、Pythonのboto3ライブラリを使用して、AWSアカウント内に作成されたテーブルの特定のバージョンを削除する方法を解説します。

課題： boto3ライブラリを使って、自分のアカウントに作成された特定のバージョンのテーブルを削除します。

例： データベース「test」に作成されたテーブル「security」のバージョン1を削除します。

解決のためのアプローチとアルゴリズム

ステップ1： 例外処理のためにboto3とbotocore.exceptionsをインポートします。

ステップ2： AWS Glueカタログから削除する対象のdatabase_name（データベース名）、table_name（テーブル名）、version_id（バージョンID）をパラメータとして渡します。

ステップ3： boto3ライブラリを使用してAWSセッションを作成します。デフォルトプロファイルにregion_nameが設定されていることを確認してください。設定されていない場合は、セッション作成時に明示的にregion_nameを指定する必要があります。

ステップ4： Glue用のAWSクライアントを作成します。

ステップ5： delete_table_version関数を使用し、DatabaseNameパラメータにdatabase_name、TableNameパラメータにtable_name、VersionIdパラメータにversion_idをそれぞれ渡します。なお、VersionIdは文字列型であるため、引用符（' '）で囲んで渡す必要がある点に注意してください。また、テーブルの最新バージョンは削除できず、古いバージョンのみ削除可能です。最新バージョンを削除したい場合は、delete_table関数を使用してテーブル自体を削除してください。

ステップ6： 指定した古いバージョンのテーブルが削除され、レスポンスメタデータが返されます。

ステップ7： 処理中に問題が発生した場合に備えて、汎用例外もハンドリングしておきます。

サンプルコード

AWS Glueデータベースからテーブルの特定のバージョンを削除するには、以下のコードを使用します。

import boto3
from botocore.exceptions import ClientError

def delete_a_table_version_from_database(database_name, table_name, version_id: str):
    session = boto3.session.Session()
    glue_client = session.client('glue')
    try:
        response = glue_client.delete_table_version(DatabaseName=database_name,
                                                    TableName=table_name,
                                                    VersionId=version_id)
        return response
    except ClientError as e:
        raise Exception("boto3 client error in delete_a_table_version_from_database: " + e.__str__())
    except Exception as e:
        raise Exception("Unexpected error in delete_a_table_version_from_database: " + e.__str__())

print(delete_a_table_version_from_database("test", "security", "1"))

実行結果

{'ResponseMetadata': {'RequestId': '7aa7c3cb…………….-…….8a238c',
'HTTPStatusCode': 200, 'HTTPHeaders': {'date': 'Sun, 21 Feb 2021
04:58:04 GMT', 'content-type': 'application/x-amz-json-1.1', 'content-length': '2', 'connection': 'keep-alive', 'x-amzn-requestid': '7aa7c3cbf611-494e-b923-8610318a238c'}, 'RetryAttempts': 0}}

まとめ

このように、boto3のdelete_table_version関数を使えば、AWS Glueデータカタログ上のテーブルから任意の旧バージョンを簡単に削除できます。HTTPステータスコード200が返されれば、削除は正常に完了しています。なお、最新バージョンを削除したい場合はdelete_table関数を使用する必要がある点に留意してください。