Expose primary_name_attribute in TableInfo, fix prodev example E2E

SDK changes:
- _get_entity_by_table_schema_name now selects PrimaryNameAttribute and
  PrimaryIdAttribute from EntityDefinitions
- _create_table returns primary_name_attribute in its result dict
- TableInfo model includes primary_name_attribute and primary_id_attribute
  fields with legacy key access
- Fixes #148: tables.create() now exposes the primary column logical name

Example changes:
- prodev_quick_start.py uses result.primary_name_attribute from tables.create()
  to construct correct record payloads (fixes the demo_*_name column error)
- Both examples verified E2E against live Dataverse

Author: Saurabh Badenkal

examples/advanced/prodev_quick_start.py

@@ -100,19 +100,19 @@ def run_demo(client):
     print(f"[INFO] Output folder: {OUTPUT_DIR.resolve()}")
 
     # -- Step 1: Create 4 tables --
-    step1_create_tables(client)
+    primary_name_col = step1_create_tables(client)
 
     # -- Step 2: Create relationships --
     step2_create_relationships(client)
 
     # -- Step 3: Populate with sample data --
-    customer_ids, project_ids, task_ids = step3_populate_data(client)
+    customer_ids, project_ids, task_ids = step3_populate_data(client, primary_name_col)
 
     # -- Step 4: Query and analyze --
-    step4_query_and_analyze(client, customer_ids)
+    step4_query_and_analyze(client, customer_ids, primary_name_col)
 
     # -- Step 5: Update and delete --
-    step5_update_and_delete(client, task_ids)
+    step5_update_and_delete(client, task_ids, primary_name_col)
 
     # -- Step 6: Cleanup --
     cleanup(client)
@@ -134,15 +134,18 @@ def step1_create_tables(client):
     print("-" * 60)
 
     # Customer table
-    client.tables.create(
+    result = client.tables.create(
         TABLE_CUSTOMER,
         {
             f"{TABLE_CUSTOMER}_Email": "string",
             f"{TABLE_CUSTOMER}_Industry": "string",
             f"{TABLE_CUSTOMER}_Revenue": "money",
         },
     )
-    print(f"[OK] Created table: {TABLE_CUSTOMER}")
+    # The primary name column logical name is returned by tables.create()
+    # so we know exactly what key to use in create payloads.
+    primary_name_col = result.primary_name_attribute
+    print(f"[OK] Created table: {TABLE_CUSTOMER} (primary column: {primary_name_col})")
 
     # Project table
     client.tables.create(
@@ -177,6 +180,9 @@ def step1_create_tables(client):
     )
     print(f"[OK] Created table: {TABLE_TIMEENTRY}")
     print(f"[OK] All 4 tables created with prefix '{PREFIX}'")
+    print(f"[INFO] Primary name column: '{primary_name_col}'")
+
+    return primary_name_col
 
 
 # ================================================================
@@ -225,7 +231,7 @@ def step2_create_relationships(client):
 # ================================================================
 
 
-def step3_populate_data(client):
+def step3_populate_data(client, primary_name_col):
     """Create sample records using client.dataframe.create().
 
     Why DataFrames here instead of client.records.create()?
@@ -252,10 +258,8 @@ def step3_populate_data(client):
     print("-" * 60)
 
     # -- Customers --
-    # Note: The primary column logical name is {prefix}_name (lowercase),
-    # and custom column logical names follow the same lowercase convention.
-    # The SDK lowercases keys automatically, so we use the schema names here.
-    name_col = f"{PREFIX}_Name"
+    # Use the primary name column returned by tables.create()
+    name_col = primary_name_col
     customers_df = pd.DataFrame(
         [
             {
@@ -364,15 +368,15 @@ def step3_populate_data(client):
 # ================================================================
 
 
-def step4_query_and_analyze(client, customer_ids):
+def step4_query_and_analyze(client, customer_ids, primary_name_col):
     """Query data and demonstrate DataFrame analysis."""
     print("\n" + "-" * 60)
     print("STEP 4: Query and analyze data")
     print("-" * 60)
 
     # Query all projects as a DataFrame
     # Note: select uses logical names (lowercase). The SDK lowercases automatically.
-    name_attr = f"{PREFIX}_name"  # primary column logical name
+    name_attr = primary_name_col
     projects = client.dataframe.get(
         TABLE_PROJECT,
         select=[
@@ -437,7 +441,7 @@ def step4_query_and_analyze(client, customer_ids):
 # ================================================================
 
 
-def step5_update_and_delete(client, task_ids):
+def step5_update_and_delete(client, task_ids, primary_name_col):
     """Demonstrate update and delete with DataFrames."""
     print("\n" + "-" * 60)
     print("STEP 5: Update and delete records")
@@ -461,10 +465,9 @@ def step5_update_and_delete(client, task_ids):
     print(f"[OK] Deleted 1 task")
 
     # Verify
-    name_attr = f"{PREFIX}_name"
     remaining = client.dataframe.get(
         TABLE_TASK,
-        select=[name_attr, status_col],
+        select=[primary_name_col, status_col],
     )
     print(f"\n  Remaining tasks ({len(remaining)}):")
     print(f"{remaining.to_string(index=False)}")

src/PowerPlatform/Dataverse/data/_odata.py

@@ -960,7 +960,7 @@ def _get_entity_by_table_schema_name(
         logical_lower = table_schema_name.lower()
         logical_escaped = self._escape_odata_quotes(logical_lower)
         params = {
-            "$select": "MetadataId,LogicalName,SchemaName,EntitySetName",
+            "$select": "MetadataId,LogicalName,SchemaName,EntitySetName,PrimaryNameAttribute,PrimaryIdAttribute",
             "$filter": f"LogicalName eq '{logical_escaped}'",
         }
         r = self._request("get", url, params=params, headers=headers)
@@ -1689,6 +1689,8 @@ def _create_table(
             "table_logical_name": metadata.get("LogicalName"),
             "entity_set_name": metadata.get("EntitySetName"),
             "metadata_id": metadata.get("MetadataId"),
+            "primary_name_attribute": metadata.get("PrimaryNameAttribute"),
+            "primary_id_attribute": metadata.get("PrimaryIdAttribute"),
             "columns_created": created_cols,
         }
 

src/PowerPlatform/Dataverse/models/table_info.py

@@ -112,6 +112,8 @@ class TableInfo:
     logical_name: str = ""
     entity_set_name: str = ""
     metadata_id: str = ""
+    primary_name_attribute: Optional[str] = None
+    primary_id_attribute: Optional[str] = None
     display_name: Optional[str] = None
     description: Optional[str] = None
     columns: Optional[List[ColumnInfo]] = field(default=None, repr=False)
@@ -123,6 +125,8 @@ class TableInfo:
         "table_logical_name": "logical_name",
         "entity_set_name": "entity_set_name",
         "metadata_id": "metadata_id",
+        "primary_name_attribute": "primary_name_attribute",
+        "primary_id_attribute": "primary_id_attribute",
         "columns_created": "columns_created",
     }
 
@@ -187,6 +191,8 @@ def from_dict(cls, data: Dict[str, Any]) -> TableInfo:
             logical_name=data.get("table_logical_name", ""),
             entity_set_name=data.get("entity_set_name", ""),
             metadata_id=data.get("metadata_id", ""),
+            primary_name_attribute=data.get("primary_name_attribute"),
+            primary_id_attribute=data.get("primary_id_attribute"),
             columns_created=data.get("columns_created"),
         )
 
@@ -213,6 +219,8 @@ def from_api_response(cls, response_data: Dict[str, Any]) -> TableInfo:
             logical_name=response_data.get("LogicalName", ""),
             entity_set_name=response_data.get("EntitySetName", ""),
             metadata_id=response_data.get("MetadataId", ""),
+            primary_name_attribute=response_data.get("PrimaryNameAttribute"),
+            primary_id_attribute=response_data.get("PrimaryIdAttribute"),
             display_name=display_name,
             description=description,
         )

tests/unit/models/test_table_info.py

@@ -49,11 +49,19 @@ def test_legacy_key_iteration(self):
         keys = list(self.info)
         self.assertEqual(
             keys,
-            ["table_schema_name", "table_logical_name", "entity_set_name", "metadata_id", "columns_created"],
+            [
+                "table_schema_name",
+                "table_logical_name",
+                "entity_set_name",
+                "metadata_id",
+                "primary_name_attribute",
+                "primary_id_attribute",
+                "columns_created",
+            ],
         )
 
     def test_len(self):
-        self.assertEqual(len(self.info), 5)
+        self.assertEqual(len(self.info), 7)
 
     def test_keys_values_items(self):
         self.assertEqual(list(self.info.keys()), list(self.info._LEGACY_KEY_MAP.keys()))