# カタログ API 「カタログ API」 では、カタログを作成、削除、検索、更新、一覧表示するための API について説明します。 ## データタイプ + [カタログの構造](#aws-glue-api-catalog-catalogs-Catalog) + [CatalogInput 構造](#aws-glue-api-catalog-catalogs-CatalogInput) + [TargetRedshiftCatalog 構造](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog) + [CatalogProperties 構造](#aws-glue-api-catalog-catalogs-CatalogProperties) + [CatalogPropertiesOutput 構造](#aws-glue-api-catalog-catalogs-CatalogPropertiesOutput) + [DataLakeAccessProperties 構造](#aws-glue-api-catalog-catalogs-DataLakeAccessProperties) + [IcebergOptimizationProperties 構造](#aws-glue-api-catalog-catalogs-IcebergOptimizationProperties) + [DataLakeAccessPropertiesOutput 構造](#aws-glue-api-catalog-catalogs-DataLakeAccessPropertiesOutput) + [IcebergOptimizationPropertiesOutput 構造](#aws-glue-api-catalog-catalogs-IcebergOptimizationPropertiesOutput) + [FederatedCatalog 構造](#aws-glue-api-catalog-catalogs-FederatedCatalog) ## カタログの構造 カタログオブジェクトは、AWS Glue データカタログ内またはフェデレーティッドソース内のデータベースの論理グループを表します。Redshift フェデレーティッドカタログ、もしくは別のアカウントまたはリージョンにある Redshift データベースへのリソースリンクを含むカタログの作成が可能になりました。 **フィールド** + `CatalogId` – カタログ ID 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 カタログの ID。デフォルトのカタログへのアクセスを許可するときは、このフィールドは指定しません。 + `Name` – *必須:* UTF-8 文字列。1～64 バイト長。[Custom string pattern #25](aws-glue-api-common.md#regex_25) に一致。 カタログの名前。アカウント ID と同じにすることはできません。 + `ResourceArn` – UTF–8 文字列。 カタログリソースに割り当てられた Amazon リソースネーム (ARN)。 + `Description` – 説明文字列。2048 バイト長以下。[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) に一致。 説明文字列。2,048 バイト以下。URI アドレスの複数行の文字列パターンに一致。カタログの説明。 + `Parameters` – キーバリューペアのマップ配列。 各キーはキー文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 各値は UTF-8 文字列で、512,000 バイト長以下です。 カタログのパラメータとプロパティを定義する、キーと値のペアのマップ配列。 + `CreateTime` – タイムスタンプ。 カタログが作成された時刻。 + `UpdateTime` – タイムスタンプ。 カタログが最後に更新された時刻。 + `TargetRedshiftCatalog` – [TargetRedshiftCatalog](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog) オブジェクト。 データベースリソースのリンク用のターゲットカタログを記述する `TargetRedshiftCatalog` オブジェクト。 + `FederatedCatalog` – [FederatedCatalog](#aws-glue-api-catalog-catalogs-FederatedCatalog) オブジェクト。 AWS Glue データカタログの外部のエンティティを指す `FederatedCatalog` オブジェクト。 + `CatalogProperties` – [CatalogPropertiesOutput](#aws-glue-api-catalog-catalogs-CatalogPropertiesOutput) オブジェクト。 データレイクアクセスのプロパティとその他のカスタムプロパティを指定する `CatalogProperties` オブジェクト。 + `CreateTableDefaultPermissions` – [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions) オブジェクトの配列。 `PrincipalPermissions` オブジェクトの配列。プリンシパル用のデフォルトのアクセス権限セットをテーブルに作成します。AWS Lake Formation で使用します。AWS Glue オペレーションの通常の過程では使用されません。 + `CreateDatabaseDefaultPermissions` – [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions) オブジェクトの配列。 `PrincipalPermissions` オブジェクトの配列。プリンシパル用のデフォルトのアクセス権限セットをデータベースに作成します。AWS Lake Formation で使用します。AWS Glue オペレーションの通常の過程では使用されません。 + `AllowFullTableExternalDataAccess` – UTF-8 文字列 (有効な値: `True` \| `False`)。 Lake Formation に登録されている Amazon S3 の場所にあるデータへのアクセスをサードパーティーエンジンに許可します。 ## CatalogInput 構造 カタログプロパティを記述する構造。 **フィールド** + `Description` – 説明文字列。2,048 バイト長以下。[URI address multi-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-uri) に一致。 説明文字列。2,048 バイト以下。URI アドレスの複数行の文字列パターンに一致。カタログの説明。 + `FederatedCatalog` – [FederatedCatalog](#aws-glue-api-catalog-catalogs-FederatedCatalog) オブジェクト。 `FederatedCatalog` オブジェクト。AWS Glue データカタログの外部のエンティティ (Redshift データベースなど) を参照する `FederatedCatalog` 構造。 + `Parameters` – キーバリューペアのマップ配列。 各キーはキー文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 各値は UTF-8 文字列で、512,000 バイト長以下です。 カタログのパラメータとプロパティを定義する、キーと値のペアのマップ配列。 + `TargetRedshiftCatalog` – [TargetRedshiftCatalog](#aws-glue-api-catalog-catalogs-TargetRedshiftCatalog) オブジェクト。 リソースのリンク用のターゲットカタログを記述する `TargetRedshiftCatalog` オブジェクト。 + `CatalogProperties` – [CatalogProperties](#aws-glue-api-catalog-catalogs-CatalogProperties) オブジェクト。 データレイクアクセスのプロパティとその他のカスタムプロパティを指定する `CatalogProperties` オブジェクト。 + `CreateTableDefaultPermissions` – [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions) オブジェクトの配列。 `PrincipalPermissions` オブジェクトの配列。プリンシパル用のデフォルトのアクセス権限セットをテーブルに作成します。AWS Lake Formation で使用します。通常は空のリストとして明示的に設定する必要があります。 + `CreateDatabaseDefaultPermissions` – [PrincipalPermissions](aws-glue-api-catalog-databases.md#aws-glue-api-catalog-databases-PrincipalPermissions) オブジェクトの配列。 `PrincipalPermissions` オブジェクトの配列。プリンシパル用のデフォルトのアクセス権限セットをデータベースに作成します。AWS Lake Formation で使用します。通常は空のリストとして明示的に設定する必要があります。 + `AllowFullTableExternalDataAccess` – UTF-8 文字列 (有効な値: `True` \| `False`)。 Lake Formation に登録されている Amazon S3 の場所にあるデータへのアクセスをサードパーティーエンジンに許可します。 ## TargetRedshiftCatalog 構造 リソースのリンク用のターゲットテーブルを記述する構造。 **フィールド** + `CatalogArn` – *必須:* UTF–8 文字列。 カタログリソースの Amazon リソースネーム (ARN)。 ## CatalogProperties 構造 データレイクアクセスのプロパティとその他のカスタムプロパティを指定する構造。 **フィールド** + `DataLakeAccessProperties` – [DataLakeAccessProperties](#aws-glue-api-catalog-catalogs-DataLakeAccessProperties) オブジェクト。 AWS Glue データカタログ内のカタログリソースに対してデータレイクアクセスを設定するプロパティを指定する `DataLakeAccessProperties` オブジェクト。 + `IcebergOptimizationProperties` – [IcebergOptimizationProperties](#aws-glue-api-catalog-catalogs-IcebergOptimizationProperties) オブジェクト。 カタログの Iceberg テーブル最適化プロパティを指定する構造。これには、このカタログの Iceberg テーブルに適用できる圧縮、保持、孤立ファイル削除オペレーションの設定が含まれます。 + `CustomProperties` – キーバリューペアのマップ配列。 各キーはキー文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 各値は UTF-8 文字列で、512,000 バイト長以下です。 カタログの追加のキーと値のプロパティ。列統計の最適化など。 ## CatalogPropertiesOutput 構造 カタログリソースの設定プロパティを含むプロパティ属性。 **フィールド** + `DataLakeAccessProperties` – [DataLakeAccessPropertiesOutput](#aws-glue-api-catalog-catalogs-DataLakeAccessPropertiesOutput) オブジェクト。 AWS Glue データカタログ内のカタログリソースに対してデータレイクアクセスを設定する入力プロパティを持つ `DataLakeAccessProperties` オブジェクト。 + `IcebergOptimizationProperties` – [IcebergOptimizationPropertiesOutput](#aws-glue-api-catalog-catalogs-IcebergOptimizationPropertiesOutput) オブジェクト。 圧縮、保持、孤立ファイル削除オペレーションの設定など、カタログの Iceberg テーブル最適化設定を指定する `IcebergOptimizationPropertiesOutput` オブジェクト。 + `CustomProperties` – キーバリューペアのマップ配列。 各キーはキー文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 各値は UTF-8 文字列で、512,000 バイト長以下です。 カタログの追加のキーと値のプロパティ。列統計の最適化など。 ## DataLakeAccessProperties 構造 AWS Glue データカタログ内のカタログリソースに対してデータレイクアクセスを設定する入力プロパティ。 **フィールド** + `DataLakeAccess` – ブール。 Amazon Athena、Amazon EMR、AWS Glue ETL など、Redshift 以外のエンジンからデータカタログ内の Amazon Redshift データベースにアクセスする、Apache Spark アプリケーションのデータレイクアクセスをオンまたはオフにします。 + `DataTransferRole`– UTF-8 文字列。[Custom string pattern #53](aws-glue-api-common.md#regex_53) に一致。 クエリ中にステージングバケットとの間でデータを転送するために AWS Glue が引き受けるロール。 + `KmsKey` – UTF–8 文字列。 カタログと併せて作成されるステージングバケットに使用される暗号化キー。 + `CatalogType` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 ネイティブのカタログリソースに対してフェデレーションカタログタイプを指定します。現在サポートされているタイプは `aws:redshift` です。 ## IcebergOptimizationProperties 構造 圧縮、保持、孤立ファイル削除オペレーションの設定など、カタログの Iceberg テーブル最適化プロパティを指定する構造。 **フィールド** + `RoleArn` – UTF-8 文字列。[Custom string pattern #53](aws-glue-api-common.md#regex_53) に一致。 Iceberg テーブル最適化オペレーションを実行するために引き受けられる IAM ロールの Amazon リソースネーム (ARN)。 + `Compaction` – キーバリューペアのマップ配列。 各キーはキー文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 各値は UTF-8 文字列で、512,000 バイト長以下です。 Iceberg テーブル圧縮オペレーションの設定パラメータを指定するキーと値のペアのマップ。データファイルのレイアウトを最適化してクエリのパフォーマンスを向上させます。 + `Retention` – キーバリューペアのマップ配列。 各キーはキー文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 各値は UTF-8 文字列で、512,000 バイト長以下です。 Iceberg テーブル保持オペレーションの設定パラメータを指定するキーと値のペアのマップ。テーブルスナップショットのライフサイクルを管理し、ストレージコストを制御します。 + `OrphanFileDeletion` – キーバリューペアのマップ配列。 各キーはキー文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 各値は UTF-8 文字列で、512,000 バイト長以下です。 Iceberg 孤立ファイル削除オペレーションの設定パラメータを指定するキーと値のペアのマップ。テーブルメタデータによって参照されなくなったファイルを識別して削除します。 ## DataLakeAccessPropertiesOutput 構造 AWS Glue データカタログ内のカタログリソースに対するデータレイクアクセス設定の出力プロパティ。 **フィールド** + `DataLakeAccess` – ブール。 データカタログ内の Amazon Redshift データベースにアクセスする Apache Spark アプリケーションのデータレイクアクセスをオンまたはオフにします。 + `DataTransferRole`– UTF-8 文字列。[Custom string pattern #53](aws-glue-api-common.md#regex_53) に一致。 クエリ中にステージングバケットとの間でデータを転送するために AWS Glue が引き受けるロール。 + `KmsKey` – UTF–8 文字列。 カタログと併せて作成されるステージングバケットに使用される暗号化キー。 + `ManagedWorkgroupName` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 カタログリソース用に作成された Redshift Serverless マネージドコンピューティングの名前。 + `ManagedWorkgroupStatus` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 Redshift Serverless マネージドコンピューティングのステータス。 + `RedshiftDatabaseName` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 マネージドコンピューティングのデフォルトの Redshift データベースリソースの名前。 + `StatusMessage` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 マネージドワークグループのステータスに関する詳細情報を提供するメッセージ。 + `CatalogType` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 ネイティブのカタログリソースに対してフェデレーションカタログタイプを指定します。現在サポートされているタイプは `aws:redshift` です。 ## IcebergOptimizationPropertiesOutput 構造 AWS Glue データカタログ内のカタログリソースの Iceberg テーブル最適化設定の出力プロパティを含む構造。 **フィールド** + `RoleArn` – UTF-8 文字列。[Custom string pattern #53](aws-glue-api-common.md#regex_53) に一致。 Iceberg テーブル最適化オペレーションの実行に使用される IAM ロールの Amazon リソースネーム (ARN)。 + `Compaction` – キーバリューペアのマップ配列。 各キーはキー文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 各値は UTF-8 文字列で、512,000 バイト長以下です。 Iceberg テーブル圧縮オペレーションの設定パラメータを指定するキーと値のペアのマップ。データファイルのレイアウトを最適化してクエリのパフォーマンスを向上させます。 + `Retention` – キーバリューペアのマップ配列。 各キーはキー文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 各値は UTF-8 文字列で、512,000 バイト長以下です。 Iceberg テーブル保持オペレーションの設定パラメータを指定するキーと値のペアのマップ。テーブルスナップショットのライフサイクルを管理し、ストレージコストを制御します。 + `OrphanFileDeletion` – キーバリューペアのマップ配列。 各キーはキー文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 各値は UTF-8 文字列で、512,000 バイト長以下です。 Iceberg 孤立ファイル削除オペレーションの設定パラメータを指定するキーと値のペアのマップ。テーブルメタデータによって参照されなくなったファイルを識別して削除します。 + `LastUpdatedTime` – タイムスタンプ。 Iceberg 最適化プロパティが最後に更新されたタイムスタンプ。 ## FederatedCatalog 構造 AWS Glue データカタログの外部のエンティティを指すカタログ。 **フィールド** + `Identifier` - UTF-8 文字列。1 ～ 512 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 フェデレーションカタログの一意の識別子。 + `ConnectionName` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 外部データソース (Redshift フェデレーティッドカタログなど) への接続の名前。 + `ConnectionType` – UTF-8 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 フェデレーティッドカタログへのアクセスに使用される接続のタイプで、外部データソースへの接続のプロトコルまたは方法を指定します。 ## 操作 + [CreateCatalog アクション (Python: create\_catalog)](#aws-glue-api-catalog-catalogs-CreateCatalog) + [UpdateCatalog アクション (Python: update\_catalog)](#aws-glue-api-catalog-catalogs-UpdateCatalog) + [DeleteCatalog アクション (Python: delete\_catalog)](#aws-glue-api-catalog-catalogs-DeleteCatalog) + [GetCatalog アクション (Python: get\_catalog)](#aws-glue-api-catalog-catalogs-GetCatalog) + [GetCatalogs アクション (Python: get\_catalogs)](#aws-glue-api-catalog-catalogs-GetCatalogs) ## CreateCatalog アクション (Python: create\_catalog) AWS Glue データカタログに新しいカタログを作成します。 **リクエスト** + `Name` – *必須:* UTF-8 文字列。1～64 バイト長。[Custom string pattern #25](aws-glue-api-common.md#regex_25) に一致。 作成するカタログの名前。 + `CatalogInput` – *必須:* [CatalogInput](#aws-glue-api-catalog-catalogs-CatalogInput) オブジェクト。 カタログのメタデータを定義する `CatalogInput` オブジェクト。 + `Tags` – キーと値のペアのマップ配列。50 ペア以下。 各キーは UTF-8 文字列で、1～128 バイト長です。 各値は UTF-8 文字列で、256 バイト長以下です。 キーバリューペアのマップ配列。50 ペア以下。各キーは UTF-8 文字列で、1～128 バイト長です。各値は UTF-8 文字列で、256 バイト長以下です。カタログに割り当てるタグ。 **応答** + *応答パラメータはありません。* **エラー** + `InvalidInputException` + `AlreadyExistsException` + `ResourceNumberLimitExceededException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `ConcurrentModificationException` + `AccessDeniedException` + `EntityNotFoundException` + `FederatedResourceAlreadyExistsException` + `FederationSourceException` ## UpdateCatalog アクション (Python: update\_catalog) AWS Glue データカタログ内の既存のカタログのプロパティを更新します。 **リクエスト** + `CatalogId` – *必須:* カタログ ID 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 カタログの ID。 + `CatalogInput` – *必須:* [CatalogInput](#aws-glue-api-catalog-catalogs-CatalogInput) オブジェクト。 既存のカタログの新しいプロパティを指定する `CatalogInput` オブジェクト。 **応答** + *応答パラメータはありません。* **エラー** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `ConcurrentModificationException` + `AccessDeniedException` + `FederationSourceException` ## DeleteCatalog アクション (Python: delete\_catalog) 指定されたカタログを AWS Glue データカタログから削除します。 このオペレーションが完了すると、削除されたカタログ内のデータベース、テーブル (それらのテーブルに属する可能性のあるすべてのテーブルのバージョンとパーティションも含む)、ユーザー定義の関数にアクセスできなくなります。AWS Glue では、このサービスの裁量により、これらの「孤立した」リソースを適時に非同期的に削除します。 関連するすべてのリソースを直ちに削除するには、`DeleteCatalog` を呼び出す前に、`DeleteTableVersion` (または `BatchDeleteTableVersion`)、`DeletePartition` (または `BatchDeletePartition`)、`DeleteTable` (または `BatchDeleteTable`)、`DeleteUserDefinedFunction`、`DeleteDatabase` を使用して、カタログに属するすべてのリソースを削除します。 **リクエスト** + `CatalogId` – *必須:* カタログ ID 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 カタログの ID。 **応答** + *応答パラメータはありません。* **エラー** + `EntityNotFoundException` + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `ConcurrentModificationException` + `AccessDeniedException` + `FederationSourceException` ## GetCatalog アクション (Python: get\_catalog) 取得するカタログの名前。すべて小文字にします。 **リクエスト** + `CatalogId` – *必須:* カタログ ID 文字列。1～255 バイト長。[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 カタログが属する親カタログの ID。設定されていない場合は、デフォルトで AWS のアカウント番号が使用されます。 **応答** + `Catalog` – [カタログ](#aws-glue-api-catalog-catalogs-Catalog) オブジェクト。 `Catalog` オブジェクト。AWS Glue データカタログ内の指定されたカタログの定義。 **エラー** + `InvalidInputException` + `EntityNotFoundException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `AccessDeniedException` + `EntityNotFoundException` + `FederationSourceException` + `FederationSourceRetryableException` ## GetCatalogs アクション (Python: get\_catalogs) AWS Glue データカタログのカタログで定義されているすべてのカタログを取得します。Redshift フェデレーティッドカタログのユースケースの場合、このオペレーションは、Redshift 名前空間カタログ内の Redshift データベースにマッピングされたカタログのリストを返します。 **リクエスト** + `ParentCatalogId` – カタログ ID 文字列、1～255 バイト長、[Single-line string pattern](aws-glue-api-common.md#aws-glue-api-regex-oneLine) に一致。 カタログが属する親カタログの ID。設定されていない場合は、デフォルトで AWS のアカウント番号が使用されます。 + `NextToken` – UTF-8 文字列。 継続トークン (これが継続呼び出しの場合)。 + `MaxResults` – 1～1000 の数値 (整数)。 1 回の応答で返されるカタログの最大数。 + `Recursive` – ブール。 カタログ階層内のすべてのカタログを `ParentCatalogId` から一覧表示するかどうか。デフォルトは `false` です。`true` の場合、`ParentCatalogID` 階層内のすべてのカタログオブジェクトがレスポンス内に一覧表示されます。 + `IncludeRoot` – ブール。 アカウントとリージョンのデフォルトカタログをレスポンス内に一覧表示するかどうか。デフォルトは `false` です。`true` と `ParentCatalogId = NULL | AWS Account ID` の場合、すべてのカタログとデフォルトカタログがレスポンス内に一覧表示されます。 `ParentCatalogId` が null に等しくなく、この属性が `false` または `true`として渡されると、`InvalidInputException` がスローされます。 **応答** + `CatalogList` – *必須:* [カタログ](#aws-glue-api-catalog-catalogs-Catalog) オブジェクトの配列。 `Catalog` オブジェクトの配列。指定された親カタログの `Catalog` オブジェクトのリスト。 + `NextToken` – UTF-8 文字列。 返されたトークンのリストをページ分割するための継続トークン。リストの現在のセグメントが最後のセグメントではない場合に返されます。 **エラー** + `InvalidInputException` + `InternalServiceException` + `OperationTimeoutException` + `GlueEncryptionException` + `AccessDeniedException` + `EntityNotFoundException` + `FederationSourceException` + `FederationSourceRetryableException`