TableInfo 类

具有类似于听写的向后兼容性的表元数据。

支持新的属性访问（info.schema_name）和旧式听写密钥访问（info["table_schema_name"]），以便向后兼容针对原始听写 API 编写的代码。

示例：


   info = client.tables.create("new_Product", {"new_Price": "decimal"})
   print(info.schema_name)              # new attribute access
   print(info["table_schema_name"])     # legacy dict-key access

构造函数

TableInfo(schema_name: str = '', logical_name: str = '', entity_set_name: str = '', metadata_id: str = '', primary_name_attribute: str | None = None, primary_id_attribute: str | None = None, display_name: str | None = None, description: str | None = None, columns: List[ColumnInfo] | None = None, columns_created: List[str] | None = None)

参数

名称	说明
schema_name 必需	str 表架构名称（例如 `"Account"`）。
logical_name 必需	str 表逻辑名称（小写）。
entity_set_name 必需	str OData 实体集名称。
metadata_id 必需	str 元数据 GUID。
display_name	str 人工可读的显示名称。默认值: None
description	str 表说明。默认值: None
columns	list[ColumnInfo] 或 None 列元数据（检索时）。默认值: None
columns_created	list[str] 或 None 使用表创建的列架构名称。默认值: None
primary_name_attribute	默认值: None
primary_id_attribute	默认值: None

方法

from_api_response	从原始 Dataverse `EntityDefinition` API 响应创建。
from_dict	从 SDK 内部听写（snake_case密钥）创建。这将处理 OData 层和 OData 层中返回的`_create_table_get_table_info`听写格式。
get	返回键的值，或默认值（如果不存在）。
items	返回（legacy_key，值）对。
keys	返回旧式听写密钥。
to_dict	返回包含旧密钥的听写，以实现向后兼容性。
values	返回与旧式听写键对应的值。

from_api_response

从原始 Dataverse EntityDefinition API 响应创建。

from_api_response(response_data: Dict[str, Any]) -> TableInfo

参数

名称	说明
response_data 必需	dict 原始实体元数据听写（PascalCase 键）。

类型	说明
TableInfo

from_dict

从 SDK 内部听写（snake_case密钥）创建。

这将处理 OData 层和 OData 层中返回的_create_table_get_table_info听写格式。

from_dict(data: Dict[str, Any]) -> TableInfo

参数

名称	说明
data 必需	dict 包含 SDK snake_case键的字典。

类型	说明
TableInfo

get

返回键的值，或默认值（如果不存在）。

get(key: str, default: Any = None) -> Any

参数

名称	说明
key 必需
default	默认值: None

items

返回（legacy_key，值）对。

items() -> List[tuple]

keys

返回旧式听写密钥。

keys() -> KeysView[str]

to_dict

返回包含旧密钥的听写，以实现向后兼容性。

to_dict() -> Dict[str, Any]

values

返回与旧式听写键对应的值。

values() -> List[Any]

属性

columns

columns: List[ColumnInfo] | None = None

columns_created

columns_created: List[str] | None = None

description

description: str | None = None

display_name

display_name: str | None = None

entity_set_name

entity_set_name: str = ''

logical_name

logical_name: str = ''

metadata_id

metadata_id: str = ''

primary_id_attribute

primary_id_attribute: str | None = None

primary_name_attribute

primary_name_attribute: str | None = None

schema_name

schema_name: str = ''