Function table_format_from_dict

sdk/python/feast/table_format.py:469–509

Create TableFormat instance from dictionary representation. This function deserializes a dictionary (typically from JSON or protobuf) back into the appropriate TableFormat instance. The dictionary must contain a 'format_type' field that indicates which format class to instantiate.

(data: Dict)

def table_format_from_dict(data: Dict) -> TableFormat:
    """
    Create TableFormat instance from dictionary representation.

    This function deserializes a dictionary (typically from JSON or protobuf)
    back into the appropriate TableFormat instance. The dictionary must contain
    a 'format_type' field that indicates which format class to instantiate.

    Args:
        data (Dict): Dictionary containing table format configuration. Must include
            'format_type' field with value 'iceberg', 'delta', or 'hudi'.

    Returns:
        TableFormat: An instance of the appropriate TableFormat subclass.

    Raises:
        ValueError: If format_type is not recognized.
        KeyError: If format_type field is missing from data.

    Examples:
        Deserialize an Iceberg format:

        >>> data = {
        ...     "format_type": "iceberg",
        ...     "catalog": "my_catalog",
        ...     "namespace": "my_db"
        ... }
        >>> iceberg_format = table_format_from_dict(data)
    """
    if "format_type" not in data:
        raise KeyError("Missing 'format_type' field in data")
    format_type = data["format_type"]

    if format_type == TableFormatType.ICEBERG.value:
        return IcebergFormat.from_dict(data)
    elif format_type == TableFormatType.DELTA.value:
        return DeltaFormat.from_dict(data)
    elif format_type == TableFormatType.HUDI.value:
        return HudiFormat.from_dict(data)
    else:
        raise ValueError(f"Unknown table format type: {format_type}")


def table_format_from_json(json_str: str) -> TableFormat: