本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

Iceberg 中繼資料管理

當您使用 Iceberg 資料表格式建立功能群組時，Amazon SageMaker Feature Store 會使用預設組態值代表您建立和管理基礎 Iceberg 資料表。您可以在特徵群組建立時設定 Iceberg 資料表屬性、更新現有特徵群組上的屬性，以及檢視目前在資料表上設定的屬性。這些設定可讓您控制組態參數，例如快照保留、中繼資料檔案管理和寫入行為，以管理離線儲存資料表的整體大小和效能。

只有一部分的 Iceberg 資料表屬性已驗證與特徵商店的相容性。設定此支援集以外的屬性並不保證行為正確。如需支援屬性的完整清單，請參閱 允許 Iceberg 屬性。

先決條件：您的功能群組必須使用 Iceberg 資料表格式具有離線存放區。

IcebergProperties 類型

IcebergProperties 類型為 Iceberg 屬性組態提供經過驗證的包裝函式，確保所有金鑰都屬於允許的集合，並防止重複的項目。

class IcebergProperties(Base):
    """Configuration for Iceberg table properties in a Feature Group offline store."""
    properties: Optional[Dict[str, str]] = None

驗證屬性

當傳遞給建立或更新函數時，無效和重複的金鑰會導致錯誤。您可以選擇性地使用 validate_property_keys()方法驗證金鑰。這在從現有IcebergProperties物件新增或移除屬性時很有用。

iceberg_properties = IcebergProperties(  # Validates on creation
    properties={
        "write.target-file-size-bytes": "268435456",
        "write.delete.mode": "merge-on-read",
    }
)

# Add non-allowed property
iceberg_properties.properties.update({"write.delete.isolation-level": "Snapshot"})

# Validate again — throws error because of non-allowed property
iceberg_properties.validate_property_keys()

建立具有 Iceberg 屬性的功能群組

FeatureGroupManager.create 函數接受 類型的 iceberg_properties 參數IcebergProperties。它會建立特徵群組，並等待建立完成，然後再更新基礎 AWS Glue 資料表上的 Iceberg 屬性。

或者，您可以建立 FeatureGroup、呼叫 create，然後將特徵群組物件傳遞至 FeatureGroupManager類別，並在特徵群組完成建立時呼叫 update以避免封鎖。

fg = FeatureGroupManager.create(
    # ...other parameters...
    offline_store_config=OfflineStoreConfig(
        s3_storage_config=S3StorageConfig(s3_uri="s3://my-bucket/features/"),
        table_format="Iceberg",  # Must use Iceberg table format
    ),
    iceberg_properties=IcebergProperties(
        properties={
            "write.target-file-size-bytes": "536870912",
            "history.expire.min-snapshots-to-keep": "3",
        }
    ),
)

更新現有功能群組上的 Iceberg 屬性

update 函數接受 類型的 iceberg_properties 參數IcebergProperties。它需要已建立的功能群組、擷取離線存放 AWS Glue Data Catalog 區的 ，並設定指定的 Iceberg 屬性。

fg = FeatureGroupManager.get(feature_group_name="my-feature-group")
fg.update(
    iceberg_properties=IcebergProperties(
        properties={
            "write.target-file-size-bytes": "268435456",
            "write.delete.mode": "merge-on-read",
        }
    ),
)

檢視特徵群組上的 Iceberg 屬性

FeatureGroupManager.get 函數接受 include_iceberg_properties 參數。當設定為 時True，它會擷取已手動設定且為允許清單一部分的 Iceberg 屬性，並將其新增至傳回物件中的 iceberg_properties 欄位。

這只會傳回屬於允許清單一部分的集合屬性。若要取得所有 AWS Glue 資料表屬性，請直接使用 AWS Glue API。如果允許的 Iceberg 屬性未顯示，表示尚未明確設定並使用其預設值。

fg = FeatureGroupManager.get(
    feature_group_name="my-feature-group",
    include_iceberg_properties=True,
)
print(fg.iceberg_properties.properties)
# e.g. {"write.target-file-size-bytes": "536870912"}

所需的許可

確保 AmazonSageMakerFeatureStoreAccess 和 AmazonSageMakerFullAccess 受管政策都連接到您正在使用的 IAM 角色。根據您的存取模式管理您的政策。

允許 Iceberg 屬性

下表列出已驗證可搭配 Feature Store 使用的 Iceberg 資料表屬性。如需這些屬性的詳細資訊，請參閱 Apache Iceberg 文件中的資料表組態。