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)

參數

名稱	Description
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 層回傳`_create_table_get_table_info`的 dict 格式。
get	鍵值回傳值，或如果不存在則用預設值。
items	回傳（legacy_key，值）對。
keys	還原舊有的 Dict Key。
to_dict	回傳帶有舊有金鑰的字典以實現向下相容。
values	回傳值對應於舊有的 dict 鍵。

from_api_response

從原始的 Dataverse EntityDefinition API 回應建立。

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

參數

名稱	Description
response_data 必要	dict 原始實體元資料指令（PascalCase 鍵）。

傳回

類型	Description
TableInfo

from_dict

從 SDK 內部指令（snake_case 鍵）來建立。

這處理 OData 層回傳_create_table_get_table_info的 dict 格式。

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

參數

名稱	Description
data 必要	dict 用 SDK snake_case 鍵的字典。

傳回

類型	Description
TableInfo

get

鍵值回傳 值，或如果不存在則用預設值。

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

參數

名稱	Description
key 必要
default	預設值: None

items

回傳（legacy_key，值）對。

items() -> List[tuple]

keys

還原舊有的 Dict Key。

keys() -> KeysView[str]

to_dict

回傳帶有舊有金鑰的字典以實現向下相容。

to_dict() -> Dict[str, Any]

values

回傳值對應於舊有的 dict 鍵。

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 = ''