RelationshipInfo 类

关系元数据的类型化返回模型。

返回者 create_one_to_many_relationship、 create_many_to_many_relationship、 get_relationship和 create_lookup_field。

例：


   result = client.tables.create_one_to_many_relationship(lookup, relationship)
   print(result.relationship_schema_name)
   print(result.lookup_schema_name)

构造函数

RelationshipInfo(relationship_id: str | None = None, relationship_schema_name: str = '', relationship_type: str = '', lookup_schema_name: str | None = None, referenced_entity: str | None = None, referencing_entity: str | None = None, entity1_logical_name: str | None = None, entity2_logical_name: str | None = None)

参数

名称	说明
relationship_id	str 关系元数据 GUID。默认值: None
relationship_schema_name 必需	str 关系架构名称。
relationship_type 必需	str `"one_to_many"` 或 `"many_to_many"`。
lookup_schema_name	str 查阅字段架构名称（仅一对多）。默认值: None
referenced_entity	str 父实体逻辑名称（仅一对多）。默认值: None
referencing_entity	str 子实体逻辑名称（仅一对多）。默认值: None
entity1_logical_name	str 第一个实体逻辑名称（仅限多对多）。默认值: None
entity2_logical_name	str 第二个实体逻辑名称（仅多对多）。默认值: None

方法

from_api_response

从原始 Dataverse Web API 响应创建。

从响应中的字段检测一对多与多对多 @odata.type ，并将 PascalCase 键映射到snake_case属性。 Dataverse 仅支持这两种关系类型：无法识别 @odata.type 的 ValueError引发。

from_many_to_many

从多对多关系结果创建。

from_one_to_many

从一对多关系结果创建。

from_api_response

从原始 Dataverse Web API 响应创建。

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

参数

名称	说明
response_data 必需	dict Web API 中的原始关系元数据。

类型	说明
RelationshipInfo

例外

类型	说明
ValueError	`@odata.type`如果不是识别的关系类型。

from_many_to_many

从多对多关系结果创建。

from_many_to_many(*, relationship_id: str | None, relationship_schema_name: str, entity1_logical_name: str, entity2_logical_name: str) -> RelationshipInfo

参数

名称	说明
relationship_id 必需	str 关系元数据 GUID。
relationship_schema_name 必需	str 关系架构名称。
entity1_logical_name 必需	str 第一个实体逻辑名称。
entity2_logical_name 必需	str 第二个实体逻辑名称。

仅限关键字的参数

名称	说明
relationship_id 必需
relationship_schema_name 必需
entity1_logical_name 必需
entity2_logical_name 必需

类型	说明
RelationshipInfo

from_one_to_many

从一对多关系结果创建。

from_one_to_many(*, relationship_id: str | None, relationship_schema_name: str, lookup_schema_name: str, referenced_entity: str, referencing_entity: str) -> RelationshipInfo

参数

名称	说明
relationship_id 必需	str 关系元数据 GUID。
relationship_schema_name 必需	str 关系架构名称。
lookup_schema_name 必需	str 查阅字段架构名称。
referenced_entity 必需	str 父实体逻辑名称。
referencing_entity 必需	str 子实体逻辑名称。

仅限关键字的参数

名称	说明
relationship_id 必需
relationship_schema_name 必需
lookup_schema_name 必需
referenced_entity 必需
referencing_entity 必需

类型	说明
RelationshipInfo

属性

entity1_logical_name

entity1_logical_name: str | None = None

entity2_logical_name

entity2_logical_name: str | None = None

lookup_schema_name

lookup_schema_name: str | None = None

referenced_entity

referenced_entity: str | None = None

referencing_entity

referencing_entity: str | None = None

relationship_id

relationship_id: str | None = None

relationship_schema_name

relationship_schema_name: str = ''

relationship_type

relationship_type: str = ''