From b33ad0a788b837783411f1539173d91071453fde Mon Sep 17 00:00:00 2001
From: Tamas Nemeth <treff7es@gmail.com>
Date: Wed, 30 Oct 2024 17:41:45 +0100
Subject: [PATCH 01/21] feat(ingest/datahub): Add way to filter soft deleted
 entities (#11738)

---
 .../ingestion/source/datahub/config.py        |  15 +-
 .../source/datahub/datahub_api_reader.py      |  13 +-
 .../source/datahub/datahub_database_reader.py | 153 ++++++++++++------
 .../source/datahub/datahub_kafka_reader.py    |   5 +
 .../source/datahub/datahub_source.py          |  42 +++--
 .../ingestion/source/datahub/report.py        |   2 +
 .../tests/unit/test_datahub_source.py         |  52 +++---
 7 files changed, 190 insertions(+), 92 deletions(-)

diff --git a/metadata-ingestion/src/datahub/ingestion/source/datahub/config.py b/metadata-ingestion/src/datahub/ingestion/source/datahub/config.py
index 9705d63912b8d..a3304334cb1eb 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/datahub/config.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/datahub/config.py
@@ -1,5 +1,5 @@
 import os
-from typing import Optional
+from typing import Optional, Set
 
 from pydantic import Field, root_validator
 
@@ -35,6 +35,19 @@ class DataHubSourceConfig(StatefulIngestionConfigBase):
         ),
     )
 
+    include_soft_deleted_entities: bool = Field(
+        default=True,
+        description=(
+            "If enabled, include entities that have been soft deleted. "
+            "Otherwise, include all entities regardless of removal status. "
+        ),
+    )
+
+    exclude_aspects: Set[str] = Field(
+        default_factory=set,
+        description="Set of aspect names to exclude from ingestion",
+    )
+
     database_query_batch_size: int = Field(
         default=DEFAULT_DATABASE_BATCH_SIZE,
         description="Number of records to fetch from the database at a time",
diff --git a/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_api_reader.py b/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_api_reader.py
index 6986aac0a7757..382a0d548e38d 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_api_reader.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_api_reader.py
@@ -26,11 +26,17 @@ def __init__(
         self.report = report
         self.graph = graph
 
-    def get_aspects(self) -> Iterable[MetadataChangeProposalWrapper]:
+    def get_urns(self) -> Iterable[str]:
         urns = self.graph.get_urns_by_filter(
-            status=RemovedStatusFilter.ALL,
+            status=RemovedStatusFilter.ALL
+            if self.config.include_soft_deleted_entities
+            else RemovedStatusFilter.NOT_SOFT_DELETED,
             batch_size=self.config.database_query_batch_size,
         )
+        return urns
+
+    def get_aspects(self) -> Iterable[MetadataChangeProposalWrapper]:
+        urns = self.get_urns()
         tasks: List[futures.Future[Iterable[MetadataChangeProposalWrapper]]] = []
         with futures.ThreadPoolExecutor(
             max_workers=self.config.max_workers
@@ -43,6 +49,9 @@ def get_aspects(self) -> Iterable[MetadataChangeProposalWrapper]:
     def _get_aspects_for_urn(self, urn: str) -> Iterable[MetadataChangeProposalWrapper]:
         aspects: Dict[str, _Aspect] = self.graph.get_entity_semityped(urn)  # type: ignore
         for aspect in aspects.values():
+            if aspect.get_aspect_name().lower() in self.config.exclude_aspects:
+                continue
+
             yield MetadataChangeProposalWrapper(
                 entityUrn=urn,
                 aspect=aspect,
diff --git a/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_database_reader.py b/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_database_reader.py
index e4f1bb275487e..faa281097de4c 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_database_reader.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_database_reader.py
@@ -1,11 +1,10 @@
+import contextlib
 import json
 import logging
 from datetime import datetime
-from typing import Any, Generic, Iterable, List, Optional, Tuple, TypeVar
+from typing import Any, Dict, Generic, Iterable, List, Optional, Tuple, TypeVar
 
 from sqlalchemy import create_engine
-from sqlalchemy.engine import Row
-from typing_extensions import Protocol
 
 from datahub.emitter.aspect import ASPECT_MAP
 from datahub.emitter.mcp import MetadataChangeProposalWrapper
@@ -21,13 +20,7 @@
 # Should work for at least mysql, mariadb, postgres
 DATETIME_FORMAT = "%Y-%m-%d %H:%M:%S.%f"
 
-
-class VersionOrderable(Protocol):
-    createdon: Any  # Should restrict to only orderable types
-    version: int
-
-
-ROW = TypeVar("ROW", bound=VersionOrderable)
+ROW = TypeVar("ROW", bound=Dict[str, Any])
 
 
 class VersionOrderer(Generic[ROW]):
@@ -54,14 +47,14 @@ def _process_row(self, row: ROW) -> Iterable[ROW]:
             return
 
         yield from self._attempt_queue_flush(row)
-        if row.version == 0:
+        if row["version"] == 0:
             self._add_to_queue(row)
         else:
             yield row
 
     def _add_to_queue(self, row: ROW) -> None:
         if self.queue is None:
-            self.queue = (row.createdon, [row])
+            self.queue = (row["createdon"], [row])
         else:
             self.queue[1].append(row)
 
@@ -69,7 +62,7 @@ def _attempt_queue_flush(self, row: ROW) -> Iterable[ROW]:
         if self.queue is None:
             return
 
-        if row.createdon > self.queue[0]:
+        if row["createdon"] > self.queue[0]:
             yield from self._flush_queue()
 
     def _flush_queue(self) -> Iterable[ROW]:
@@ -92,6 +85,21 @@ def __init__(
             **connection_config.options,
         )
 
+    @property
+    def soft_deleted_urns_query(self) -> str:
+        return f"""
+            SELECT DISTINCT mav.urn
+            FROM {self.engine.dialect.identifier_preparer.quote(self.config.database_table_name)} as mav
+            JOIN (
+                SELECT *,
+                JSON_EXTRACT(metadata, '$.removed') as removed
+                FROM {self.engine.dialect.identifier_preparer.quote(self.config.database_table_name)}
+                WHERE aspect = "status" AND version = 0
+            ) as sd ON sd.urn = mav.urn
+            WHERE sd.removed = true
+            ORDER BY mav.urn
+        """
+
     @property
     def query(self) -> str:
         # May repeat rows for the same date
@@ -101,66 +109,117 @@ def query(self) -> str:
         # Relies on createdon order to reflect version order
         # Ordering of entries with the same createdon is handled by VersionOrderer
         return f"""
-            SELECT urn, aspect, metadata, systemmetadata, createdon, version
-            FROM {self.engine.dialect.identifier_preparer.quote(self.config.database_table_name)}
-            WHERE createdon >= %(since_createdon)s
-            {"" if self.config.include_all_versions else "AND version = 0"}
-            ORDER BY createdon, urn, aspect, version
-            LIMIT %(limit)s
-            OFFSET %(offset)s
+        SELECT *
+        FROM (
+            SELECT
+                mav.urn,
+                mav.aspect,
+                mav.metadata,
+                mav.systemmetadata,
+                mav.createdon,
+                mav.version,
+                removed
+            FROM {self.engine.dialect.identifier_preparer.quote(self.config.database_table_name)} as mav
+            LEFT JOIN (
+                SELECT
+                    *,
+                    JSON_EXTRACT(metadata, '$.removed') as removed
+                FROM {self.engine.dialect.identifier_preparer.quote(self.config.database_table_name)}
+                WHERE aspect = 'status'
+                AND version = 0
+            ) as sd ON sd.urn = mav.urn
+            WHERE 1 = 1
+                {"" if self.config.include_all_versions else "AND mav.version = 0"}
+                {"" if not self.config.exclude_aspects else "AND mav.aspect NOT IN %(exclude_aspects)s"}
+                AND mav.createdon >= %(since_createdon)s
+            ORDER BY
+                createdon,
+                urn,
+                aspect,
+                version
+        ) as t
+        WHERE 1=1
+            {"" if self.config.include_soft_deleted_entities else "AND (removed = false or removed is NULL)"}
+        ORDER BY
+            createdon,
+            urn,
+            aspect,
+            version
         """
 
     def get_aspects(
         self, from_createdon: datetime, stop_time: datetime
     ) -> Iterable[Tuple[MetadataChangeProposalWrapper, datetime]]:
-        orderer = VersionOrderer[Row](enabled=self.config.include_all_versions)
+        orderer = VersionOrderer[Dict[str, Any]](
+            enabled=self.config.include_all_versions
+        )
         rows = self._get_rows(from_createdon=from_createdon, stop_time=stop_time)
         for row in orderer(rows):
             mcp = self._parse_row(row)
             if mcp:
-                yield mcp, row.createdon
+                yield mcp, row["createdon"]
 
-    def _get_rows(self, from_createdon: datetime, stop_time: datetime) -> Iterable[Row]:
+    def _get_rows(
+        self, from_createdon: datetime, stop_time: datetime
+    ) -> Iterable[Dict[str, Any]]:
         with self.engine.connect() as conn:
-            ts = from_createdon
-            offset = 0
-            while ts.timestamp() <= stop_time.timestamp():
-                logger.debug(f"Polling database aspects from {ts}")
-                rows = conn.execute(
+            with contextlib.closing(conn.connection.cursor()) as cursor:
+                cursor.execute(
                     self.query,
-                    since_createdon=ts.strftime(DATETIME_FORMAT),
-                    limit=self.config.database_query_batch_size,
-                    offset=offset,
+                    {
+                        "exclude_aspects": list(self.config.exclude_aspects),
+                        "since_createdon": from_createdon.strftime(DATETIME_FORMAT),
+                    },
                 )
-                if not rows.rowcount:
-                    return
 
-                for i, row in enumerate(rows):
-                    yield row
+                columns = [desc[0] for desc in cursor.description]
+                while True:
+                    rows = cursor.fetchmany(self.config.database_query_batch_size)
+                    if not rows:
+                        return
+                    for row in rows:
+                        yield dict(zip(columns, row))
 
-                if ts == row.createdon:
-                    offset += i + 1
-                else:
-                    ts = row.createdon
-                    offset = 0
+    def get_soft_deleted_rows(self) -> Iterable[Dict[str, Any]]:
+        """
+        Fetches all soft-deleted entities from the database.
 
-    def _parse_row(self, row: Row) -> Optional[MetadataChangeProposalWrapper]:
+        Yields:
+            Row objects containing URNs of soft-deleted entities
+        """
+        with self.engine.connect() as conn:
+            with contextlib.closing(conn.connection.cursor()) as cursor:
+                logger.debug("Polling soft-deleted urns from database")
+                cursor.execute(self.soft_deleted_urns_query)
+                columns = [desc[0] for desc in cursor.description]
+                while True:
+                    rows = cursor.fetchmany(self.config.database_query_batch_size)
+                    if not rows:
+                        return
+                    for row in rows:
+                        yield dict(zip(columns, row))
+
+    def _parse_row(
+        self, row: Dict[str, Any]
+    ) -> Optional[MetadataChangeProposalWrapper]:
         try:
-            json_aspect = post_json_transform(json.loads(row.metadata))
-            json_metadata = post_json_transform(json.loads(row.systemmetadata or "{}"))
+            json_aspect = post_json_transform(json.loads(row["metadata"]))
+            json_metadata = post_json_transform(
+                json.loads(row["systemmetadata"] or "{}")
+            )
             system_metadata = SystemMetadataClass.from_obj(json_metadata)
             return MetadataChangeProposalWrapper(
-                entityUrn=row.urn,
-                aspect=ASPECT_MAP[row.aspect].from_obj(json_aspect),
+                entityUrn=row["urn"],
+                aspect=ASPECT_MAP[row["aspect"]].from_obj(json_aspect),
                 systemMetadata=system_metadata,
                 changeType=ChangeTypeClass.UPSERT,
             )
         except Exception as e:
             logger.warning(
-                f"Failed to parse metadata for {row.urn}: {e}", exc_info=True
+                f'Failed to parse metadata for {row["urn"]}: {e}', exc_info=True
             )
             self.report.num_database_parse_errors += 1
             self.report.database_parse_errors.setdefault(
                 str(e), LossyDict()
-            ).setdefault(row.aspect, LossyList()).append(row.urn)
+            ).setdefault(row["aspect"], LossyList()).append(row["urn"])
             return None
diff --git a/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_kafka_reader.py b/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_kafka_reader.py
index d9e53e87c2cea..56a3d55abb184 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_kafka_reader.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_kafka_reader.py
@@ -36,6 +36,7 @@ def __init__(
         self.connection_config = connection_config
         self.report = report
         self.group_id = f"{KAFKA_GROUP_PREFIX}-{ctx.pipeline_name}"
+        self.ctx = ctx
 
     def __enter__(self) -> "DataHubKafkaReader":
         self.consumer = DeserializingConsumer(
@@ -95,6 +96,10 @@ def _poll_partition(
                 )
                 break
 
+            if mcl.aspectName and mcl.aspectName in self.config.exclude_aspects:
+                self.report.num_kafka_excluded_aspects += 1
+                continue
+
             # TODO: Consider storing state in kafka instead, via consumer.commit()
             yield mcl, PartitionOffset(partition=msg.partition(), offset=msg.offset())
 
diff --git a/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_source.py b/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_source.py
index 0204a864e2b9e..de212ca9a6771 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_source.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/datahub/datahub_source.py
@@ -62,13 +62,18 @@ def get_workunits_internal(self) -> Iterable[MetadataWorkUnit]:
         self.report.stop_time = datetime.now(tz=timezone.utc)
         logger.info(f"Ingesting DataHub metadata up until {self.report.stop_time}")
         state = self.stateful_ingestion_handler.get_last_run_state()
+        database_reader: Optional[DataHubDatabaseReader] = None
 
         if self.config.pull_from_datahub_api:
             yield from self._get_api_workunits()
 
         if self.config.database_connection is not None:
+            database_reader = DataHubDatabaseReader(
+                self.config, self.config.database_connection, self.report
+            )
+
             yield from self._get_database_workunits(
-                from_createdon=state.database_createdon_datetime
+                from_createdon=state.database_createdon_datetime, reader=database_reader
             )
             self._commit_progress()
         else:
@@ -77,7 +82,19 @@ def get_workunits_internal(self) -> Iterable[MetadataWorkUnit]:
             )
 
         if self.config.kafka_connection is not None:
-            yield from self._get_kafka_workunits(from_offsets=state.kafka_offsets)
+            soft_deleted_urns = []
+            if not self.config.include_soft_deleted_entities:
+                if database_reader is None:
+                    raise ValueError(
+                        "Cannot exclude soft deleted entities without a database connection"
+                    )
+                soft_deleted_urns = [
+                    row["urn"] for row in database_reader.get_soft_deleted_rows()
+                ]
+
+            yield from self._get_kafka_workunits(
+                from_offsets=state.kafka_offsets, soft_deleted_urns=soft_deleted_urns
+            )
             self._commit_progress()
         else:
             logger.info(
@@ -85,15 +102,9 @@ def get_workunits_internal(self) -> Iterable[MetadataWorkUnit]:
             )
 
     def _get_database_workunits(
-        self, from_createdon: datetime
+        self, from_createdon: datetime, reader: DataHubDatabaseReader
     ) -> Iterable[MetadataWorkUnit]:
-        if self.config.database_connection is None:
-            return
-
         logger.info(f"Fetching database aspects starting from {from_createdon}")
-        reader = DataHubDatabaseReader(
-            self.config, self.config.database_connection, self.report
-        )
         mcps = reader.get_aspects(from_createdon, self.report.stop_time)
         for i, (mcp, createdon) in enumerate(mcps):
 
@@ -113,20 +124,29 @@ def _get_database_workunits(
             self._commit_progress(i)
 
     def _get_kafka_workunits(
-        self, from_offsets: Dict[int, int]
+        self, from_offsets: Dict[int, int], soft_deleted_urns: List[str] = []
     ) -> Iterable[MetadataWorkUnit]:
         if self.config.kafka_connection is None:
             return
 
         logger.info("Fetching timeseries aspects from kafka")
         with DataHubKafkaReader(
-            self.config, self.config.kafka_connection, self.report, self.ctx
+            self.config,
+            self.config.kafka_connection,
+            self.report,
+            self.ctx,
         ) as reader:
             mcls = reader.get_mcls(
                 from_offsets=from_offsets, stop_time=self.report.stop_time
             )
             for i, (mcl, offset) in enumerate(mcls):
                 mcp = MetadataChangeProposalWrapper.try_from_mcl(mcl)
+                if mcp.entityUrn in soft_deleted_urns:
+                    self.report.num_timeseries_soft_deleted_aspects_dropped += 1
+                    logger.debug(
+                        f"Dropping soft-deleted aspect of {mcp.aspectName} on {mcp.entityUrn}"
+                    )
+                    continue
                 if mcp.changeType == ChangeTypeClass.DELETE:
                     self.report.num_timeseries_deletions_dropped += 1
                     logger.debug(
diff --git a/metadata-ingestion/src/datahub/ingestion/source/datahub/report.py b/metadata-ingestion/src/datahub/ingestion/source/datahub/report.py
index 73e5a798a1553..721fc87989442 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/datahub/report.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/datahub/report.py
@@ -20,6 +20,8 @@ class DataHubSourceReport(StatefulIngestionReport):
 
     num_kafka_aspects_ingested: int = 0
     num_kafka_parse_errors: int = 0
+    num_kafka_excluded_aspects: int = 0
     kafka_parse_errors: LossyDict[str, int] = field(default_factory=LossyDict)
 
     num_timeseries_deletions_dropped: int = 0
+    num_timeseries_soft_deleted_aspects_dropped: int = 0
diff --git a/metadata-ingestion/tests/unit/test_datahub_source.py b/metadata-ingestion/tests/unit/test_datahub_source.py
index adc131362b326..67b2b85d9af6d 100644
--- a/metadata-ingestion/tests/unit/test_datahub_source.py
+++ b/metadata-ingestion/tests/unit/test_datahub_source.py
@@ -1,51 +1,41 @@
-from dataclasses import dataclass
+from typing import Any, Dict
 
 import pytest
 
-from datahub.ingestion.source.datahub.datahub_database_reader import (
-    VersionOrderable,
-    VersionOrderer,
-)
-
-
-@dataclass
-class MockRow(VersionOrderable):
-    createdon: int
-    version: int
-    urn: str
+from datahub.ingestion.source.datahub.datahub_database_reader import VersionOrderer
 
 
 @pytest.fixture
 def rows():
     return [
-        MockRow(0, 0, "one"),
-        MockRow(0, 1, "one"),
-        MockRow(0, 0, "two"),
-        MockRow(0, 0, "three"),
-        MockRow(0, 1, "three"),
-        MockRow(0, 2, "three"),
-        MockRow(0, 1, "two"),
-        MockRow(0, 4, "three"),
-        MockRow(0, 5, "three"),
-        MockRow(1, 6, "three"),
-        MockRow(1, 0, "four"),
-        MockRow(2, 0, "five"),
-        MockRow(2, 1, "six"),
-        MockRow(2, 0, "six"),
-        MockRow(3, 0, "seven"),
-        MockRow(3, 0, "eight"),
+        {"createdon": 0, "version": 0, "urn": "one"},
+        {"createdon": 0, "version": 1, "urn": "one"},
+        {"createdon": 0, "version": 0, "urn": "two"},
+        {"createdon": 0, "version": 0, "urn": "three"},
+        {"createdon": 0, "version": 1, "urn": "three"},
+        {"createdon": 0, "version": 2, "urn": "three"},
+        {"createdon": 0, "version": 1, "urn": "two"},
+        {"createdon": 0, "version": 4, "urn": "three"},
+        {"createdon": 0, "version": 5, "urn": "three"},
+        {"createdon": 1, "version": 6, "urn": "three"},
+        {"createdon": 1, "version": 0, "urn": "four"},
+        {"createdon": 2, "version": 0, "urn": "five"},
+        {"createdon": 2, "version": 1, "urn": "six"},
+        {"createdon": 2, "version": 0, "urn": "six"},
+        {"createdon": 3, "version": 0, "urn": "seven"},
+        {"createdon": 3, "version": 0, "urn": "eight"},
     ]
 
 
 def test_version_orderer(rows):
-    orderer = VersionOrderer[MockRow](enabled=True)
+    orderer = VersionOrderer[Dict[str, Any]](enabled=True)
     ordered_rows = list(orderer(rows))
     assert ordered_rows == sorted(
-        ordered_rows, key=lambda x: (x.createdon, x.version == 0)
+        ordered_rows, key=lambda x: (x["createdon"], x["version"] == 0)
     )
 
 
 def test_version_orderer_disabled(rows):
-    orderer = VersionOrderer[MockRow](enabled=False)
+    orderer = VersionOrderer[Dict[str, Any]](enabled=False)
     ordered_rows = list(orderer(rows))
     assert ordered_rows == rows

From 93f76def1f9e693e735fff2c88133cae080cdd09 Mon Sep 17 00:00:00 2001
From: Harshal Sheth <hsheth2@gmail.com>
Date: Wed, 30 Oct 2024 10:38:33 -0700
Subject: [PATCH 02/21] fix(ingest): pin teradata dep (#11760)

---
 metadata-ingestion/setup.py | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/metadata-ingestion/setup.py b/metadata-ingestion/setup.py
index aa6dcaeeff039..db273c6e3ce46 100644
--- a/metadata-ingestion/setup.py
+++ b/metadata-ingestion/setup.py
@@ -484,7 +484,11 @@
     "teradata": sql_common
     | usage_common
     | sqlglot_lib
-    | {"teradatasqlalchemy>=17.20.0.0"},
+    | {
+        # On 2024-10-30, teradatasqlalchemy 20.0.0.2 was released. This version seemed to cause issues
+        # in our CI, so we're pinning the version for now.
+        "teradatasqlalchemy>=17.20.0.0,<=20.0.0.2",
+    },
     "trino": sql_common | trino,
     "starburst-trino-usage": sql_common | usage_common | trino,
     "nifi": {"requests", "packaging", "requests-gssapi"},

From 799c4520567f87a4c938d86ed1bd6d1cb35f2c00 Mon Sep 17 00:00:00 2001
From: Harshal Sheth <hsheth2@gmail.com>
Date: Wed, 30 Oct 2024 11:36:38 -0700
Subject: [PATCH 03/21] fix(ingest): reduce asyncio in check_upgrade (#11734)

---
 .../src/datahub/cli/ingest_cli.py             | 55 +++++----------
 .../src/datahub/upgrade/upgrade.py            | 70 +++++++++++++------
 2 files changed, 67 insertions(+), 58 deletions(-)

diff --git a/metadata-ingestion/src/datahub/cli/ingest_cli.py b/metadata-ingestion/src/datahub/cli/ingest_cli.py
index 8654e6c282ba8..51f095751f7dd 100644
--- a/metadata-ingestion/src/datahub/cli/ingest_cli.py
+++ b/metadata-ingestion/src/datahub/cli/ingest_cli.py
@@ -1,4 +1,3 @@
-import asyncio
 import csv
 import json
 import logging
@@ -24,6 +23,7 @@
 from datahub.ingestion.run.pipeline import Pipeline
 from datahub.telemetry import telemetry
 from datahub.upgrade import upgrade
+from datahub.utilities.perf_timer import PerfTimer
 
 logger = logging.getLogger(__name__)
 
@@ -126,7 +126,7 @@ def run(
 ) -> None:
     """Ingest metadata into DataHub."""
 
-    async def run_pipeline_to_completion(pipeline: Pipeline) -> int:
+    def run_pipeline_to_completion(pipeline: Pipeline) -> int:
         logger.info("Starting metadata ingestion")
         with click_spinner.spinner(disable=no_spinner or no_progress):
             try:
@@ -166,44 +166,25 @@ async def run_pipeline_to_completion(pipeline: Pipeline) -> int:
         # The default is "datahub" reporting. The extra flag will disable it.
         report_to = None
 
-    async def run_ingestion_and_check_upgrade() -> int:
-        # TRICKY: We want to make sure that the Pipeline.create() call happens on the
-        # same thread as the rest of the ingestion. As such, we must initialize the
-        # pipeline inside the async function so that it happens on the same event
-        # loop, and hence the same thread.
-
-        # logger.debug(f"Using config: {pipeline_config}")
-        pipeline = Pipeline.create(
-            pipeline_config,
-            dry_run=dry_run,
-            preview_mode=preview,
-            preview_workunits=preview_workunits,
-            report_to=report_to,
-            no_progress=no_progress,
-            raw_config=raw_pipeline_config,
-        )
+    # logger.debug(f"Using config: {pipeline_config}")
+    pipeline = Pipeline.create(
+        pipeline_config,
+        dry_run=dry_run,
+        preview_mode=preview,
+        preview_workunits=preview_workunits,
+        report_to=report_to,
+        no_progress=no_progress,
+        raw_config=raw_pipeline_config,
+    )
+    with PerfTimer() as timer:
+        ret = run_pipeline_to_completion(pipeline)
 
-        version_stats_future = asyncio.ensure_future(
-            upgrade.retrieve_version_stats(pipeline.ctx.graph)
+    # The main ingestion has completed. If it was successful, potentially show an upgrade nudge message.
+    if ret == 0:
+        upgrade.check_upgrade_post(
+            main_method_runtime=timer.elapsed_seconds(), graph=pipeline.ctx.graph
         )
-        ingestion_future = asyncio.ensure_future(run_pipeline_to_completion(pipeline))
-        ret = await ingestion_future
-
-        # The main ingestion has completed. If it was successful, potentially show an upgrade nudge message.
-        if ret == 0:
-            try:
-                # we check the other futures quickly on success
-                version_stats = await asyncio.wait_for(version_stats_future, 0.5)
-                upgrade.maybe_print_upgrade_message(version_stats=version_stats)
-            except Exception as e:
-                logger.debug(
-                    f"timed out with {e} waiting for version stats to be computed... skipping ahead."
-                )
-
-        return ret
 
-    loop = asyncio.get_event_loop()
-    ret = loop.run_until_complete(run_ingestion_and_check_upgrade())
     if ret:
         sys.exit(ret)
     # don't raise SystemExit if there's no error
diff --git a/metadata-ingestion/src/datahub/upgrade/upgrade.py b/metadata-ingestion/src/datahub/upgrade/upgrade.py
index dd2829ba0d236..fb14514588e5f 100644
--- a/metadata-ingestion/src/datahub/upgrade/upgrade.py
+++ b/metadata-ingestion/src/datahub/upgrade/upgrade.py
@@ -13,6 +13,7 @@
 from datahub import __version__
 from datahub.cli.config_utils import load_client_config
 from datahub.ingestion.graph.client import DataHubGraph
+from datahub.utilities.perf_timer import PerfTimer
 
 log = logging.getLogger(__name__)
 
@@ -113,7 +114,7 @@ async def get_server_config(gms_url: str, token: Optional[str]) -> dict:
 
     async with aiohttp.ClientSession() as session:
         config_endpoint = f"{gms_url}/config"
-        async with session.get(config_endpoint) as dh_response:
+        async with session.get(config_endpoint, headers=headers) as dh_response:
             dh_response_json = await dh_response.json()
             return dh_response_json
 
@@ -167,7 +168,28 @@ async def get_server_version_stats(
     return (server_type, server_version, current_server_release_date)
 
 
-async def retrieve_version_stats(
+def retrieve_version_stats(
+    timeout: float, graph: Optional[DataHubGraph] = None
+) -> Optional[DataHubVersionStats]:
+    version_stats: Optional[DataHubVersionStats] = None
+
+    async def _get_version_with_timeout() -> None:
+        # TODO: Once we're on Python 3.11+, replace with asyncio.timeout.
+        stats_future = _retrieve_version_stats(graph)
+
+        try:
+            nonlocal version_stats
+            version_stats = await asyncio.wait_for(stats_future, timeout=timeout)
+        except asyncio.TimeoutError:
+            log.debug("Timed out while fetching version stats")
+
+    loop = asyncio.get_event_loop()
+    loop.run_until_complete(_get_version_with_timeout())
+
+    return version_stats
+
+
+async def _retrieve_version_stats(
     server: Optional[DataHubGraph] = None,
 ) -> Optional[DataHubVersionStats]:
     try:
@@ -263,7 +285,7 @@ def is_client_server_compatible(client: VersionStats, server: VersionStats) -> i
         return server.version.micro - client.version.micro
 
 
-def maybe_print_upgrade_message(  # noqa: C901
+def _maybe_print_upgrade_message(  # noqa: C901
     version_stats: Optional[DataHubVersionStats],
 ) -> None:  # noqa: C901
     days_before_cli_stale = 7
@@ -378,28 +400,34 @@ def maybe_print_upgrade_message(  # noqa: C901
             pass
 
 
+def clip(val: float, min_val: float, max_val: float) -> float:
+    return max(min_val, min(val, max_val))
+
+
+def check_upgrade_post(
+    main_method_runtime: float,
+    graph: Optional[DataHubGraph] = None,
+) -> None:
+    # Guarantees: this method will not throw, and will not block for more than 3 seconds.
+
+    version_stats_timeout = clip(main_method_runtime / 10, 0.7, 3.0)
+    try:
+        version_stats = retrieve_version_stats(
+            timeout=version_stats_timeout, graph=graph
+        )
+        _maybe_print_upgrade_message(version_stats=version_stats)
+    except Exception as e:
+        log.debug(f"Failed to check for upgrades due to {e}")
+
+
 def check_upgrade(func: Callable[..., T]) -> Callable[..., T]:
     @wraps(func)
     def async_wrapper(*args: Any, **kwargs: Any) -> Any:
-        async def run_inner_func():
-            return func(*args, **kwargs)
-
-        async def run_func_check_upgrade():
-            version_stats_future = asyncio.ensure_future(retrieve_version_stats())
-            main_func_future = asyncio.ensure_future(run_inner_func())
-            ret = await main_func_future
-
-            # the main future has returned
-            # we check the other futures quickly
-            try:
-                version_stats = await asyncio.wait_for(version_stats_future, 0.5)
-                maybe_print_upgrade_message(version_stats=version_stats)
-            except Exception:
-                log.debug("timed out waiting for version stats to be computed")
+        with PerfTimer() as timer:
+            ret = func(*args, **kwargs)
 
-            return ret
+        check_upgrade_post(main_method_runtime=timer.elapsed_seconds())
 
-        loop = asyncio.get_event_loop()
-        loop.run_until_complete(run_func_check_upgrade())
+        return ret
 
     return async_wrapper

From 143fc011fa41734f0aefb17f449a78461db68205 Mon Sep 17 00:00:00 2001
From: Harshal Sheth <hsheth2@gmail.com>
Date: Wed, 30 Oct 2024 11:40:45 -0700
Subject: [PATCH 04/21] feat(ingest/powerbi): add timeouts for m-query parsing
 (#11753)

---
 metadata-ingestion/setup.py                   | 13 ++++-
 .../source/bigquery_v2/bigquery_schema.py     |  4 +-
 .../ingestion/source/powerbi/config.py        | 19 ++++---
 .../source/powerbi/m_query/parser.py          | 24 ++++++--
 .../source/powerbi/m_query/resolver.py        |  5 +-
 .../ingestion/source/powerbi/powerbi.py       | 56 ++++++++++++-------
 .../powerbi/rest_api_wrapper/data_classes.py  |  3 +
 .../powerbi/rest_api_wrapper/data_resolver.py |  6 +-
 .../powerbi/rest_api_wrapper/powerbi_api.py   | 34 +++++++----
 .../datahub/utilities/threading_timeout.py    | 42 ++++++++++++++
 .../powerbi/golden_test_container.json        | 10 +++-
 ..._config_and_modified_since_admin_only.json |  5 +-
 .../powerbi/golden_test_personal_ingest.json  |  5 +-
 .../unit/utilities/test_threading_timeout.py  | 31 ++++++++++
 14 files changed, 201 insertions(+), 56 deletions(-)
 create mode 100644 metadata-ingestion/src/datahub/utilities/threading_timeout.py
 create mode 100644 metadata-ingestion/tests/unit/utilities/test_threading_timeout.py

diff --git a/metadata-ingestion/setup.py b/metadata-ingestion/setup.py
index db273c6e3ce46..606c2b89303b7 100644
--- a/metadata-ingestion/setup.py
+++ b/metadata-ingestion/setup.py
@@ -276,6 +276,10 @@
     *path_spec_common,
 }
 
+threading_timeout_common = {
+    "stopit==1.1.2",
+}
+
 abs_base = {
     "azure-core==1.29.4",
     "azure-identity>=1.17.1",
@@ -492,7 +496,14 @@
     "trino": sql_common | trino,
     "starburst-trino-usage": sql_common | usage_common | trino,
     "nifi": {"requests", "packaging", "requests-gssapi"},
-    "powerbi": microsoft_common | {"lark[regex]==1.1.4", "sqlparse"} | sqlglot_lib,
+    "powerbi": (
+        (
+            microsoft_common
+            | {"lark[regex]==1.1.4", "sqlparse", "more-itertools"}
+            | sqlglot_lib
+            | threading_timeout_common
+        )
+    ),
     "powerbi-report-server": powerbi_report_server,
     "vertica": sql_common | {"vertica-sqlalchemy-dialect[vertica-python]==0.0.8.2"},
     "unity-catalog": databricks | sql_common | sqllineage_lib,
diff --git a/metadata-ingestion/src/datahub/ingestion/source/bigquery_v2/bigquery_schema.py b/metadata-ingestion/src/datahub/ingestion/source/bigquery_v2/bigquery_schema.py
index 4f18c22c108a6..58317b108bef4 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/bigquery_v2/bigquery_schema.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/bigquery_v2/bigquery_schema.py
@@ -175,7 +175,7 @@ def __init__(
 
     def get_query_result(self, query: str) -> RowIterator:
         def _should_retry(exc: BaseException) -> bool:
-            logger.debug(f"Exception occured for job query. Reason: {exc}")
+            logger.debug(f"Exception occurred for job query. Reason: {exc}")
             # Jobs sometimes fail with transient errors.
             # This is not currently handled by the python-bigquery client.
             # https://github.com/googleapis/python-bigquery/issues/23
@@ -197,7 +197,7 @@ def _should_retry(exc: BaseException) -> bool:
     def get_projects(self, max_results_per_page: int = 100) -> List[BigqueryProject]:
         def _should_retry(exc: BaseException) -> bool:
             logger.debug(
-                f"Exception occured for project.list api. Reason: {exc}. Retrying api request..."
+                f"Exception occurred for project.list api. Reason: {exc}. Retrying api request..."
             )
             self.report.num_list_projects_retry_request += 1
             return True
diff --git a/metadata-ingestion/src/datahub/ingestion/source/powerbi/config.py b/metadata-ingestion/src/datahub/ingestion/source/powerbi/config.py
index 8a3f8ed6131a2..0aec9a589cf27 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/powerbi/config.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/powerbi/config.py
@@ -19,6 +19,7 @@
 from datahub.ingestion.source.state.stateful_ingestion_base import (
     StatefulIngestionConfigBase,
 )
+from datahub.utilities.lossy_collections import LossyList
 
 logger = logging.getLogger(__name__)
 
@@ -176,11 +177,18 @@ class SupportedDataPlatform(Enum):
 
 @dataclass
 class PowerBiDashboardSourceReport(StaleEntityRemovalSourceReport):
+    all_workspace_count: int = 0
+    filtered_workspace_names: LossyList[str] = dataclass_field(
+        default_factory=LossyList
+    )
+    filtered_workspace_types: LossyList[str] = dataclass_field(
+        default_factory=LossyList
+    )
+
     dashboards_scanned: int = 0
     charts_scanned: int = 0
     filtered_dashboards: List[str] = dataclass_field(default_factory=list)
     filtered_charts: List[str] = dataclass_field(default_factory=list)
-    number_of_workspaces: int = 0
 
     def report_dashboards_scanned(self, count: int = 1) -> None:
         self.dashboards_scanned += count
@@ -194,9 +202,6 @@ def report_dashboards_dropped(self, model: str) -> None:
     def report_charts_dropped(self, view: str) -> None:
         self.filtered_charts.append(view)
 
-    def report_number_of_workspaces(self, number_of_workspaces: int) -> None:
-        self.number_of_workspaces = number_of_workspaces
-
 
 def default_for_dataset_type_mapping() -> Dict[str, str]:
     dict_: dict = {}
@@ -331,7 +336,7 @@ class PowerBiDashboardSourceConfig(
     )
     workspace_id_as_urn_part: bool = pydantic.Field(
         default=False,
-        description="It is recommended to set this to True only if you have legacy workspaces based on Office 365 groups, as those workspaces can have identical names."
+        description="It is recommended to set this to True only if you have legacy workspaces based on Office 365 groups, as those workspaces can have identical names. "
         "To maintain backward compatibility, this is set to False which uses workspace name",
     )
     # Enable/Disable extracting ownership information of Dashboard
@@ -371,8 +376,8 @@ class PowerBiDashboardSourceConfig(
     # any existing tags defined to those entities
     extract_endorsements_to_tags: bool = pydantic.Field(
         default=False,
-        description="Whether to extract endorsements to tags, note that this may overwrite existing tags. Admin API "
-        "access is required is this setting is enabled",
+        description="Whether to extract endorsements to tags, note that this may overwrite existing tags. "
+        "Admin API access is required if this setting is enabled.",
     )
     filter_dataset_endorsements: AllowDenyPattern = pydantic.Field(
         default=AllowDenyPattern.allow_all(),
diff --git a/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/parser.py b/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/parser.py
index 3edaaed2ff814..086ce2c263b0c 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/parser.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/parser.py
@@ -1,6 +1,7 @@
 import functools
 import importlib.resources as pkg_resource
 import logging
+import os
 from typing import Dict, List
 
 import lark
@@ -19,9 +20,12 @@
     TRACE_POWERBI_MQUERY_PARSER,
 )
 from datahub.ingestion.source.powerbi.rest_api_wrapper.data_classes import Table
+from datahub.utilities.threading_timeout import TimeoutException, threading_timeout
 
 logger = logging.getLogger(__name__)
 
+_M_QUERY_PARSE_TIMEOUT = int(os.getenv("DATAHUB_POWERBI_M_QUERY_PARSE_TIMEOUT", 60))
+
 
 @functools.lru_cache(maxsize=1)
 def get_lark_parser() -> Lark:
@@ -41,7 +45,8 @@ def _parse_expression(expression: str) -> Tree:
     expression = expression.replace("\u00a0", " ")
 
     logger.debug(f"Parsing expression = {expression}")
-    parse_tree: Tree = lark_parser.parse(expression)
+    with threading_timeout(_M_QUERY_PARSE_TIMEOUT):
+        parse_tree: Tree = lark_parser.parse(expression)
 
     if TRACE_POWERBI_MQUERY_PARSER:
         logger.debug(parse_tree.pretty())
@@ -83,17 +88,26 @@ def get_upstream_tables(
                 context=f"table-full-name={table.full_name}, expression={table.expression}, message={message}",
             )
             return []
+    except KeyboardInterrupt:
+        raise
+    except TimeoutException:
+        reporter.warning(
+            title="M-Query Parsing Timeout",
+            message=f"M-Query parsing timed out after {_M_QUERY_PARSE_TIMEOUT} seconds. Lineage for this table will not be extracted.",
+            context=f"table-full-name={table.full_name}, expression={table.expression}",
+        )
+        return []
     except (
         BaseException
     ) as e:  # TODO: Debug why BaseException is needed here and below.
         if isinstance(e, lark.exceptions.UnexpectedCharacters):
-            title = "Unexpected Character Found"
+            error_type = "Unexpected Character Error"
         else:
-            title = "Unknown Parsing Error"
+            error_type = "Unknown Parsing Error"
 
         reporter.warning(
-            title=title,
-            message="Unknown parsing error",
+            title="Unable to extract lineage from M-Query expression",
+            message=f"Got an '{error_type}' while parsing the expression. Lineage will be missing for this table.",
             context=f"table-full-name={table.full_name}, expression={table.expression}",
             exc=e,
         )
diff --git a/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/resolver.py b/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/resolver.py
index 20fb0b5facbbc..a5fb6fd2673ac 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/resolver.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/resolver.py
@@ -473,8 +473,9 @@ def internal(
             )
             if v_statement is None:
                 self.reporter.report_warning(
-                    f"{self.table.full_name}-variable-statement",
-                    f"output variable ({current_identifier}) statement not found in table expression",
+                    title="Unable to extract lineage from M-Query expression",
+                    message="Lineage will be incomplete.",
+                    context=f"table-full-name={self.table.full_name}: output-variable={current_identifier} not found in table expression",
                 )
                 return None
 
diff --git a/metadata-ingestion/src/datahub/ingestion/source/powerbi/powerbi.py b/metadata-ingestion/src/datahub/ingestion/source/powerbi/powerbi.py
index 72336afbaacd0..b2afdc3e40931 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/powerbi/powerbi.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/powerbi/powerbi.py
@@ -7,6 +7,8 @@
 from datetime import datetime
 from typing import Iterable, List, Optional, Tuple, Union
 
+import more_itertools
+
 import datahub.emitter.mce_builder as builder
 import datahub.ingestion.source.powerbi.rest_api_wrapper.data_classes as powerbi_data_classes
 from datahub.emitter.mcp import MetadataChangeProposalWrapper
@@ -795,6 +797,11 @@ def generate_container_for_workspace(
             container_key=self.workspace_key,
             name=workspace.name,
             sub_types=[workspace.type],
+            extra_properties={
+                "workspace_id": workspace.id,
+                "workspace_name": workspace.name,
+                "workspace_type": workspace.type,
+            },
         )
         return container_work_units
 
@@ -1256,20 +1263,33 @@ def create(cls, config_dict, ctx):
 
     def get_allowed_workspaces(self) -> List[powerbi_data_classes.Workspace]:
         all_workspaces = self.powerbi_client.get_workspaces()
+        logger.info(f"Number of workspaces = {len(all_workspaces)}")
+        self.reporter.all_workspace_count = len(all_workspaces)
+        logger.debug(
+            f"All workspaces: {[workspace.format_name_for_logger() for workspace in all_workspaces]}"
+        )
 
-        allowed_wrk = [
-            workspace
-            for workspace in all_workspaces
-            if self.source_config.workspace_id_pattern.allowed(workspace.id)
-            and workspace.type in self.source_config.workspace_type_filter
-        ]
+        allowed_workspaces = []
+        for workspace in all_workspaces:
+            if not self.source_config.workspace_id_pattern.allowed(workspace.id):
+                self.reporter.filtered_workspace_names.append(
+                    f"{workspace.id} - {workspace.name}"
+                )
+                continue
+            elif workspace.type not in self.source_config.workspace_type_filter:
+                self.reporter.filtered_workspace_types.append(
+                    f"{workspace.id} - {workspace.name} (type = {workspace.type})"
+                )
+                continue
+            else:
+                allowed_workspaces.append(workspace)
 
-        logger.info(f"Number of workspaces = {len(all_workspaces)}")
-        self.reporter.report_number_of_workspaces(len(all_workspaces))
-        logger.info(f"Number of allowed workspaces = {len(allowed_wrk)}")
-        logger.debug(f"Workspaces = {all_workspaces}")
+        logger.info(f"Number of allowed workspaces = {len(allowed_workspaces)}")
+        logger.debug(
+            f"Allowed workspaces: {[workspace.format_name_for_logger() for workspace in allowed_workspaces]}"
+        )
 
-        return allowed_wrk
+        return allowed_workspaces
 
     def validate_dataset_type_mapping(self):
         powerbi_data_platforms: List[str] = [
@@ -1480,16 +1500,10 @@ def get_workunits_internal(self) -> Iterable[MetadataWorkUnit]:
         # Fetch PowerBi workspace for given workspace identifier
 
         allowed_workspaces = self.get_allowed_workspaces()
-        workspaces_len = len(allowed_workspaces)
-
-        batch_size = (
-            self.source_config.scan_batch_size
-        )  # 100 is the maximum allowed for powerbi scan
-        num_batches = (workspaces_len + batch_size - 1) // batch_size
-        batches = [
-            allowed_workspaces[i * batch_size : (i + 1) * batch_size]
-            for i in range(num_batches)
-        ]
+
+        batches = more_itertools.chunked(
+            allowed_workspaces, self.source_config.scan_batch_size
+        )
         for batch_workspaces in batches:
             for workspace in self.powerbi_client.fill_workspaces(
                 batch_workspaces, self.reporter
diff --git a/metadata-ingestion/src/datahub/ingestion/source/powerbi/rest_api_wrapper/data_classes.py b/metadata-ingestion/src/datahub/ingestion/source/powerbi/rest_api_wrapper/data_classes.py
index 9407ef7a51b58..fc5cd76458a51 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/powerbi/rest_api_wrapper/data_classes.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/powerbi/rest_api_wrapper/data_classes.py
@@ -96,6 +96,9 @@ def get_workspace_key(
             instance=platform_instance,
         )
 
+    def format_name_for_logger(self) -> str:
+        return f"{self.name} ({self.id})"
+
 
 @dataclass
 class DataSource:
diff --git a/metadata-ingestion/src/datahub/ingestion/source/powerbi/rest_api_wrapper/data_resolver.py b/metadata-ingestion/src/datahub/ingestion/source/powerbi/rest_api_wrapper/data_resolver.py
index f8fff2391d10b..7a47c40976bec 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/powerbi/rest_api_wrapper/data_resolver.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/powerbi/rest_api_wrapper/data_resolver.py
@@ -811,7 +811,7 @@ def _is_scan_result_ready(
             res.raise_for_status()
 
             if res.json()[Constant.STATUS].upper() == Constant.SUCCEEDED:
-                logger.info(f"Scan result is available for scan id({scan_id})")
+                logger.debug(f"Scan result is available for scan id({scan_id})")
                 return True
 
             if retry == max_retry:
@@ -898,8 +898,8 @@ def get_users(self, workspace_id: str, entity: str, entity_id: str) -> List[User
         return users
 
     def get_scan_result(self, scan_id: str) -> Optional[dict]:
-        logger.info("Fetching scan result")
-        logger.info(f"{Constant.SCAN_ID}={scan_id}")
+        logger.debug("Fetching scan result")
+        logger.debug(f"{Constant.SCAN_ID}={scan_id}")
         scan_result_get_endpoint = AdminAPIResolver.API_ENDPOINTS[
             Constant.SCAN_RESULT_GET
         ]
diff --git a/metadata-ingestion/src/datahub/ingestion/source/powerbi/rest_api_wrapper/powerbi_api.py b/metadata-ingestion/src/datahub/ingestion/source/powerbi/rest_api_wrapper/powerbi_api.py
index b67f257d9eb5b..e137f175c15ad 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/powerbi/rest_api_wrapper/powerbi_api.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/powerbi/rest_api_wrapper/powerbi_api.py
@@ -303,7 +303,7 @@ def _get_scan_result(self, workspace_ids: List[str]) -> Any:
                 )
             return None
 
-        logger.info("Waiting for scan to complete")
+        logger.debug("Waiting for scan to complete")
         if (
             self.__admin_api_resolver.wait_for_scan_to_complete(
                 scan_id=scan_id, timeout=self.__config.scan_timeout
@@ -355,22 +355,32 @@ def _get_workspace_datasets(self, workspace: Workspace) -> dict:
         logger.debug("Processing scan result for datasets")
 
         for dataset_dict in datasets:
-            dataset_instance: PowerBIDataset = self._get_resolver().get_dataset(
-                workspace=workspace,
-                dataset_id=dataset_dict[Constant.ID],
-            )
+            dataset_id = dataset_dict[Constant.ID]
+            try:
+                dataset_instance = self._get_resolver().get_dataset(
+                    workspace=workspace,
+                    dataset_id=dataset_id,
+                )
+                if dataset_instance is None:
+                    continue
+            except Exception as e:
+                self.reporter.warning(
+                    title="Unable to fetch dataset details",
+                    message="Skipping this dataset due to the error. Metadata will be incomplete.",
+                    context=f"workspace={workspace.name}, dataset-id={dataset_id}",
+                    exc=e,
+                )
+                continue
 
             # fetch + set dataset parameters
             try:
                 dataset_parameters = self._get_resolver().get_dataset_parameters(
                     workspace_id=workspace.id,
-                    dataset_id=dataset_dict[Constant.ID],
+                    dataset_id=dataset_id,
                 )
                 dataset_instance.parameters = dataset_parameters
             except Exception as e:
-                logger.info(
-                    f"Unable to fetch dataset parameters for {dataset_dict[Constant.ID]}: {e}"
-                )
+                logger.info(f"Unable to fetch dataset parameters for {dataset_id}: {e}")
 
             if self.__config.extract_endorsements_to_tags:
                 dataset_instance.tags = self._parse_endorsement(
@@ -564,8 +574,7 @@ def _fill_metadata_from_scan_result(
                 )
             else:
                 logger.info(
-                    "Skipping endorsements tag as extract_endorsements_to_tags is set to "
-                    "false "
+                    "Skipping endorsements tag as extract_endorsements_to_tags is not enabled"
                 )
 
             self._populate_app_details(
@@ -641,6 +650,9 @@ def fill_dashboard_tags() -> None:
     def fill_workspaces(
         self, workspaces: List[Workspace], reporter: PowerBiDashboardSourceReport
     ) -> Iterable[Workspace]:
+        logger.info(
+            f"Fetching initial metadata for workspaces: {[workspace.format_name_for_logger() for workspace in workspaces]}"
+        )
 
         workspaces = self._fill_metadata_from_scan_result(workspaces=workspaces)
         # First try to fill the admin detail as some regular metadata contains lineage to admin metadata
diff --git a/metadata-ingestion/src/datahub/utilities/threading_timeout.py b/metadata-ingestion/src/datahub/utilities/threading_timeout.py
new file mode 100644
index 0000000000000..e2caf57ad2116
--- /dev/null
+++ b/metadata-ingestion/src/datahub/utilities/threading_timeout.py
@@ -0,0 +1,42 @@
+import contextlib
+import functools
+import platform
+from typing import ContextManager
+
+from stopit import ThreadingTimeout as _ThreadingTimeout, TimeoutException
+
+__all__ = ["threading_timeout", "TimeoutException"]
+
+
+@functools.lru_cache(maxsize=1)
+def _is_cpython() -> bool:
+    """Check if we're running on CPython."""
+    return platform.python_implementation() == "CPython"
+
+
+def threading_timeout(timeout: float) -> ContextManager[None]:
+    """A timeout context manager that uses stopit's ThreadingTimeout underneath.
+
+    This is only supported on CPython.
+    That's because stopit.ThreadingTimeout uses a CPython-internal method to raise
+    an exception (the timeout error) in another thread. See stopit.threadstop.async_raise.
+
+    Reference: https://github.com/glenfant/stopit
+
+    Args:
+        timeout: The timeout in seconds. If <= 0, no timeout is applied.
+
+    Raises:
+        RuntimeError: If the timeout is not supported on the current Python implementation.
+        TimeoutException: If the timeout is exceeded.
+    """
+
+    if timeout <= 0:
+        return contextlib.nullcontext()
+
+    if not _is_cpython():
+        raise RuntimeError(
+            f"Timeout is only supported on CPython, not {platform.python_implementation()}"
+        )
+
+    return _ThreadingTimeout(timeout, swallow_exc=False)
diff --git a/metadata-ingestion/tests/integration/powerbi/golden_test_container.json b/metadata-ingestion/tests/integration/powerbi/golden_test_container.json
index e8be3aa9c0ac7..1039240942a5e 100644
--- a/metadata-ingestion/tests/integration/powerbi/golden_test_container.json
+++ b/metadata-ingestion/tests/integration/powerbi/golden_test_container.json
@@ -8,7 +8,10 @@
         "json": {
             "customProperties": {
                 "platform": "powerbi",
-                "workspace": "demo-workspace"
+                "workspace": "demo-workspace",
+                "workspace_id": "64ED5CAD-7C10-4684-8180-826122881108",
+                "workspace_name": "demo-workspace",
+                "workspace_type": "Workspace"
             },
             "name": "demo-workspace"
         }
@@ -3957,7 +3960,10 @@
         "json": {
             "customProperties": {
                 "platform": "powerbi",
-                "workspace": "second-demo-workspace"
+                "workspace": "second-demo-workspace",
+                "workspace_id": "64ED5CAD-7C22-4684-8180-826122881108",
+                "workspace_name": "second-demo-workspace",
+                "workspace_type": "Workspace"
             },
             "name": "second-demo-workspace"
         }
diff --git a/metadata-ingestion/tests/integration/powerbi/golden_test_most_config_and_modified_since_admin_only.json b/metadata-ingestion/tests/integration/powerbi/golden_test_most_config_and_modified_since_admin_only.json
index e134d795af9ef..0d3a0c0cc6f97 100644
--- a/metadata-ingestion/tests/integration/powerbi/golden_test_most_config_and_modified_since_admin_only.json
+++ b/metadata-ingestion/tests/integration/powerbi/golden_test_most_config_and_modified_since_admin_only.json
@@ -8,7 +8,10 @@
         "json": {
             "customProperties": {
                 "platform": "powerbi",
-                "workspace": "64ED5CAD-7C10-4684-8180-826122881108"
+                "workspace": "64ED5CAD-7C10-4684-8180-826122881108",
+                "workspace_id": "64ED5CAD-7C10-4684-8180-826122881108",
+                "workspace_name": "demo-workspace",
+                "workspace_type": "Workspace"
             },
             "name": "demo-workspace"
         }
diff --git a/metadata-ingestion/tests/integration/powerbi/golden_test_personal_ingest.json b/metadata-ingestion/tests/integration/powerbi/golden_test_personal_ingest.json
index f8c0fdc17c880..c605f939235cd 100644
--- a/metadata-ingestion/tests/integration/powerbi/golden_test_personal_ingest.json
+++ b/metadata-ingestion/tests/integration/powerbi/golden_test_personal_ingest.json
@@ -8,7 +8,10 @@
         "json": {
             "customProperties": {
                 "platform": "powerbi",
-                "workspace": "Jane Smith Workspace"
+                "workspace": "Jane Smith Workspace",
+                "workspace_id": "90E9E256-3D6D-4D38-86C8-6CCCBD8C170C",
+                "workspace_name": "Jane Smith Workspace",
+                "workspace_type": "PersonalGroup"
             },
             "name": "Jane Smith Workspace"
         }
diff --git a/metadata-ingestion/tests/unit/utilities/test_threading_timeout.py b/metadata-ingestion/tests/unit/utilities/test_threading_timeout.py
new file mode 100644
index 0000000000000..c52d18bdd55c2
--- /dev/null
+++ b/metadata-ingestion/tests/unit/utilities/test_threading_timeout.py
@@ -0,0 +1,31 @@
+import time
+
+import pytest
+
+from datahub.utilities.threading_timeout import TimeoutException, threading_timeout
+
+
+def test_timeout_no_timeout():
+    # Should complete without raising an exception
+    with threading_timeout(1.0):
+        time.sleep(0.1)
+
+
+def test_timeout_raises():
+    # Should raise TimeoutException
+    with pytest.raises(TimeoutException):
+        with threading_timeout(0.1):
+            time.sleep(0.5)
+
+
+def test_timeout_early_exit():
+    # Test that context manager handles other exceptions properly
+    with pytest.raises(ValueError):
+        with threading_timeout(1.0):
+            raise ValueError("Early exit")
+
+
+def test_timeout_zero():
+    # Should not raise an exception
+    with threading_timeout(0.0):
+        pass

From cf3b08fecb3f9991a4f06c4828c3224ccbbb40ed Mon Sep 17 00:00:00 2001
From: RyanHolstien <RyanHolstien@users.noreply.github.com>
Date: Wed, 30 Oct 2024 13:41:09 -0500
Subject: [PATCH 05/21] fix(structuredProperties): fixes underscore behavior in
 structured property names (#11746)

Co-authored-by: david-leifker <114954101+david-leifker@users.noreply.github.com>
---
 .../models/StructuredPropertyUtils.java       |  41 ++++---
 .../request/AggregationQueryBuilderTest.java  | 112 ++++++++++++++++++
 .../request/SearchRequestHandlerTest.java     |  55 +++++++++
 .../metadata/search/utils/ESUtilsTest.java    |  84 +++++++++++++
 .../test_structured_properties.py             |  22 ++--
 5 files changed, 282 insertions(+), 32 deletions(-)

diff --git a/entity-registry/src/main/java/com/linkedin/metadata/models/StructuredPropertyUtils.java b/entity-registry/src/main/java/com/linkedin/metadata/models/StructuredPropertyUtils.java
index 885be5e00b945..41ef9c25a0f3e 100644
--- a/entity-registry/src/main/java/com/linkedin/metadata/models/StructuredPropertyUtils.java
+++ b/entity-registry/src/main/java/com/linkedin/metadata/models/StructuredPropertyUtils.java
@@ -6,7 +6,6 @@
 import static com.linkedin.metadata.Constants.STRUCTURED_PROPERTY_MAPPING_FIELD;
 import static com.linkedin.metadata.Constants.STRUCTURED_PROPERTY_MAPPING_FIELD_PREFIX;
 import static com.linkedin.metadata.Constants.STRUCTURED_PROPERTY_MAPPING_VERSIONED_FIELD;
-import static com.linkedin.metadata.Constants.STRUCTURED_PROPERTY_MAPPING_VERSIONED_FIELD_PREFIX;
 
 import com.google.common.collect.ImmutableSet;
 import com.linkedin.common.Status;
@@ -120,12 +119,13 @@ public static Optional<String> toStructuredPropertyFacetName(
       lookupDefinitionFromFilterOrFacetName(
           @Nonnull String fieldOrFacetName, @Nullable AspectRetriever aspectRetriever) {
     if (fieldOrFacetName.startsWith(STRUCTURED_PROPERTY_MAPPING_FIELD + ".")) {
-      String fqn =
-          fieldOrFacetName
-              .substring(STRUCTURED_PROPERTY_MAPPING_FIELD.length() + 1)
-              .replace(".keyword", "")
-              .replace(".delimited", "");
+      // Coming in from the UI this is structuredProperties.<FQN> + any particular specifier for
+      // subfield (.keyword etc)
+      String fqn = fieldOrFacetToFQN(fieldOrFacetName);
+
+      // FQN Maps directly to URN with urn:li:structuredProperties:FQN
       Urn urn = toURNFromFQN(fqn);
+
       Map<Urn, Map<String, Aspect>> result =
           Objects.requireNonNull(aspectRetriever)
               .getLatestAspectObjects(
@@ -223,9 +223,8 @@ public static void validateStructuredPropertyFQN(
    * @param fqn structured property's fqn
    * @return the expected structured property urn
    */
-  private static Urn toURNFromFQN(@Nonnull String fqn) {
-    return UrnUtils.getUrn(
-        String.join(":", "urn:li", STRUCTURED_PROPERTY_ENTITY_NAME, fqn.replace('_', '.')));
+  public static Urn toURNFromFQN(@Nonnull String fqn) {
+    return UrnUtils.getUrn(String.join(":", "urn:li", STRUCTURED_PROPERTY_ENTITY_NAME, fqn));
   }
 
   public static void validateFilter(
@@ -235,12 +234,13 @@ public static void validateFilter(
       return;
     }
 
-    Set<String> fieldNames = new HashSet<>();
+    Set<String> fqns = new HashSet<>();
 
     if (filter.getCriteria() != null) {
       for (Criterion c : filter.getCriteria()) {
         if (c.getField().startsWith(STRUCTURED_PROPERTY_MAPPING_FIELD_PREFIX)) {
-          fieldNames.add(stripStructuredPropertyPrefix(c.getField()));
+          String fqn = fieldOrFacetToFQN(c.getField());
+          fqns.add(fqn);
         }
       }
     }
@@ -249,24 +249,23 @@ public static void validateFilter(
       for (ConjunctiveCriterion cc : filter.getOr()) {
         for (Criterion c : cc.getAnd()) {
           if (c.getField().startsWith(STRUCTURED_PROPERTY_MAPPING_FIELD_PREFIX)) {
-            fieldNames.add(stripStructuredPropertyPrefix(c.getField()));
+            String fqn = fieldOrFacetToFQN(c.getField());
+            fqns.add(fqn);
           }
         }
       }
     }
 
-    if (!fieldNames.isEmpty()) {
-      validateStructuredPropertyFQN(fieldNames, Objects.requireNonNull(aspectRetriever));
+    if (!fqns.isEmpty()) {
+      validateStructuredPropertyFQN(fqns, Objects.requireNonNull(aspectRetriever));
     }
   }
 
-  private static String stripStructuredPropertyPrefix(String s) {
-    if (s.startsWith(STRUCTURED_PROPERTY_MAPPING_VERSIONED_FIELD_PREFIX)) {
-      return s.substring(STRUCTURED_PROPERTY_MAPPING_VERSIONED_FIELD.length() + 1).split("[.]")[0];
-    } else if (s.startsWith(STRUCTURED_PROPERTY_MAPPING_FIELD_PREFIX)) {
-      return s.substring(STRUCTURED_PROPERTY_MAPPING_FIELD.length() + 1).split("[.]")[0];
-    }
-    return s;
+  private static String fieldOrFacetToFQN(String fieldOrFacet) {
+    return fieldOrFacet
+        .substring(STRUCTURED_PROPERTY_MAPPING_FIELD.length() + 1)
+        .replace(".keyword", "")
+        .replace(".delimited", "");
   }
 
   public static Date toDate(PrimitivePropertyValue value) throws DateTimeParseException {
diff --git a/metadata-io/src/test/java/com/linkedin/metadata/search/query/request/AggregationQueryBuilderTest.java b/metadata-io/src/test/java/com/linkedin/metadata/search/query/request/AggregationQueryBuilderTest.java
index 1381e9560b7e5..cef463802a6b1 100644
--- a/metadata-io/src/test/java/com/linkedin/metadata/search/query/request/AggregationQueryBuilderTest.java
+++ b/metadata-io/src/test/java/com/linkedin/metadata/search/query/request/AggregationQueryBuilderTest.java
@@ -44,6 +44,8 @@ public class AggregationQueryBuilderTest {
   public void setup() throws RemoteInvocationException, URISyntaxException {
     Urn helloUrn = Urn.createFromString("urn:li:structuredProperty:hello");
     Urn abFghTenUrn = Urn.createFromString("urn:li:structuredProperty:ab.fgh.ten");
+    Urn underscoresAndDotsUrn =
+        Urn.createFromString("urn:li:structuredProperty:under.scores.and.dots_make_a_mess");
 
     // legacy
     aspectRetriever = mock(AspectRetriever.class);
@@ -75,6 +77,21 @@ public void setup() throws RemoteInvocationException, URISyntaxException {
                     STRUCTURED_PROPERTY_DEFINITION_ASPECT_NAME,
                     new Aspect(structPropAbFghTenDefinition.data()))));
 
+    StructuredPropertyDefinition structPropUnderscoresAndDotsDefinition =
+        new StructuredPropertyDefinition();
+    structPropUnderscoresAndDotsDefinition.setVersion(null, SetMode.REMOVE_IF_NULL);
+    structPropUnderscoresAndDotsDefinition.setValueType(
+        Urn.createFromString(DATA_TYPE_URN_PREFIX + "string"));
+    structPropUnderscoresAndDotsDefinition.setQualifiedName("under.scores.and.dots_make_a_mess");
+    structPropUnderscoresAndDotsDefinition.setDisplayName("under.scores.and.dots_make_a_mess");
+    when(aspectRetriever.getLatestAspectObjects(eq(Set.of(underscoresAndDotsUrn)), anySet()))
+        .thenReturn(
+            Map.of(
+                underscoresAndDotsUrn,
+                Map.of(
+                    STRUCTURED_PROPERTY_DEFINITION_ASPECT_NAME,
+                    new Aspect(structPropUnderscoresAndDotsDefinition.data()))));
+
     // V1
     aspectRetrieverV1 = mock(AspectRetriever.class);
     when(aspectRetrieverV1.getEntityRegistry())
@@ -105,6 +122,21 @@ public void setup() throws RemoteInvocationException, URISyntaxException {
                 Map.of(
                     STRUCTURED_PROPERTY_DEFINITION_ASPECT_NAME,
                     new Aspect(structPropAbFghTenDefinitionV1.data()))));
+
+    StructuredPropertyDefinition structPropUnderscoresAndDotsDefinitionV1 =
+        new StructuredPropertyDefinition();
+    structPropUnderscoresAndDotsDefinitionV1.setVersion("00000000000001");
+    structPropUnderscoresAndDotsDefinitionV1.setValueType(
+        Urn.createFromString(DATA_TYPE_URN_PREFIX + "string"));
+    structPropUnderscoresAndDotsDefinitionV1.setQualifiedName("under.scores.and.dots_make_a_mess");
+    structPropUnderscoresAndDotsDefinitionV1.setDisplayName("under.scores.and.dots_make_a_mess");
+    when(aspectRetrieverV1.getLatestAspectObjects(eq(Set.of(underscoresAndDotsUrn)), anySet()))
+        .thenReturn(
+            Map.of(
+                underscoresAndDotsUrn,
+                Map.of(
+                    STRUCTURED_PROPERTY_DEFINITION_ASPECT_NAME,
+                    new Aspect(structPropUnderscoresAndDotsDefinitionV1.data()))));
   }
 
   @Test
@@ -269,6 +301,46 @@ public void testAggregateOverStructuredProperty() {
         Set.of("structuredProperties.ab_fgh_ten.keyword", "structuredProperties.hello.keyword"));
   }
 
+  @Test
+  public void testAggregateOverStructuredPropertyNamespaced() {
+    SearchConfiguration config = new SearchConfiguration();
+    config.setMaxTermBucketSize(25);
+
+    AggregationQueryBuilder builder =
+        new AggregationQueryBuilder(
+            config, ImmutableMap.of(mock(EntitySpec.class), ImmutableList.of()));
+
+    List<AggregationBuilder> aggs =
+        builder.getAggregations(
+            TestOperationContexts.systemContextNoSearchAuthorization(aspectRetriever),
+            List.of("structuredProperties.under.scores.and.dots_make_a_mess"));
+    Assert.assertEquals(aggs.size(), 1);
+    AggregationBuilder aggBuilder = aggs.get(0);
+    Assert.assertTrue(aggBuilder instanceof TermsAggregationBuilder);
+    TermsAggregationBuilder agg = (TermsAggregationBuilder) aggBuilder;
+    // Check that field name is sanitized to correct field name
+    Assert.assertEquals(
+        agg.field(),
+        "structuredProperties.under_scores_and_dots_make_a_mess.keyword",
+        "Terms aggregate must be on a keyword or subfield keyword");
+
+    // Two structured properties
+    aggs =
+        builder.getAggregations(
+            TestOperationContexts.systemContextNoSearchAuthorization(aspectRetriever),
+            List.of(
+                "structuredProperties.under.scores.and.dots_make_a_mess",
+                "structuredProperties.hello"));
+    Assert.assertEquals(aggs.size(), 2);
+    Assert.assertEquals(
+        aggs.stream()
+            .map(aggr -> ((TermsAggregationBuilder) aggr).field())
+            .collect(Collectors.toSet()),
+        Set.of(
+            "structuredProperties.under_scores_and_dots_make_a_mess.keyword",
+            "structuredProperties.hello.keyword"));
+  }
+
   @Test
   public void testAggregateOverStructuredPropertyV1() {
     SearchConfiguration config = new SearchConfiguration();
@@ -309,6 +381,46 @@ public void testAggregateOverStructuredPropertyV1() {
             "structuredProperties._versioned.hello.00000000000001.string.keyword"));
   }
 
+  @Test
+  public void testAggregateOverStructuredPropertyNamespacedV1() {
+    SearchConfiguration config = new SearchConfiguration();
+    config.setMaxTermBucketSize(25);
+
+    AggregationQueryBuilder builder =
+        new AggregationQueryBuilder(
+            config, ImmutableMap.of(mock(EntitySpec.class), ImmutableList.of()));
+
+    List<AggregationBuilder> aggs =
+        builder.getAggregations(
+            TestOperationContexts.systemContextNoSearchAuthorization(aspectRetrieverV1),
+            List.of("structuredProperties.under.scores.and.dots_make_a_mess"));
+    Assert.assertEquals(aggs.size(), 1);
+    AggregationBuilder aggBuilder = aggs.get(0);
+    Assert.assertTrue(aggBuilder instanceof TermsAggregationBuilder);
+    TermsAggregationBuilder agg = (TermsAggregationBuilder) aggBuilder;
+    // Check that field name is sanitized to correct field name
+    Assert.assertEquals(
+        agg.field(),
+        "structuredProperties._versioned.under_scores_and_dots_make_a_mess.00000000000001.string.keyword",
+        "Terms aggregation must be on a keyword field or subfield.");
+
+    // Two structured properties
+    aggs =
+        builder.getAggregations(
+            TestOperationContexts.systemContextNoSearchAuthorization(aspectRetrieverV1),
+            List.of(
+                "structuredProperties.under.scores.and.dots_make_a_mess",
+                "structuredProperties._versioned.hello.00000000000001.string"));
+    Assert.assertEquals(aggs.size(), 2);
+    Assert.assertEquals(
+        aggs.stream()
+            .map(aggr -> ((TermsAggregationBuilder) aggr).field())
+            .collect(Collectors.toSet()),
+        Set.of(
+            "structuredProperties._versioned.under_scores_and_dots_make_a_mess.00000000000001.string.keyword",
+            "structuredProperties._versioned.hello.00000000000001.string.keyword"));
+  }
+
   @Test
   public void testAggregateOverFieldsAndStructProp() {
     SearchableAnnotation annotation1 =
diff --git a/metadata-io/src/test/java/com/linkedin/metadata/search/query/request/SearchRequestHandlerTest.java b/metadata-io/src/test/java/com/linkedin/metadata/search/query/request/SearchRequestHandlerTest.java
index a3ef62760d797..718a00d067ce5 100644
--- a/metadata-io/src/test/java/com/linkedin/metadata/search/query/request/SearchRequestHandlerTest.java
+++ b/metadata-io/src/test/java/com/linkedin/metadata/search/query/request/SearchRequestHandlerTest.java
@@ -1,24 +1,34 @@
 package com.linkedin.metadata.search.query.request;
 
 import static com.linkedin.datahub.graphql.resolvers.search.SearchUtils.SEARCHABLE_ENTITY_TYPES;
+import static com.linkedin.metadata.Constants.STATUS_ASPECT_NAME;
 import static com.linkedin.metadata.utils.CriterionUtils.buildCriterion;
 import static com.linkedin.metadata.utils.CriterionUtils.buildExistsCriterion;
 import static com.linkedin.metadata.utils.CriterionUtils.buildIsNullCriterion;
 import static com.linkedin.metadata.utils.SearchUtil.*;
 import static org.mockito.Mockito.mock;
+import static org.mockito.Mockito.when;
 import static org.testng.Assert.*;
 
 import com.google.common.collect.ImmutableList;
 import com.google.common.collect.ImmutableMap;
+import com.google.common.collect.ImmutableSet;
+import com.linkedin.common.urn.Urn;
+import com.linkedin.data.DataMap;
 import com.linkedin.data.template.StringArray;
 import com.linkedin.datahub.graphql.generated.EntityType;
 import com.linkedin.datahub.graphql.types.entitytype.EntityTypeMapper;
+import com.linkedin.entity.Aspect;
 import com.linkedin.metadata.TestEntitySpecBuilder;
+import com.linkedin.metadata.aspect.AspectRetriever;
+import com.linkedin.metadata.aspect.GraphRetriever;
 import com.linkedin.metadata.config.search.ExactMatchConfiguration;
 import com.linkedin.metadata.config.search.PartialConfiguration;
 import com.linkedin.metadata.config.search.SearchConfiguration;
 import com.linkedin.metadata.config.search.WordGramConfiguration;
+import com.linkedin.metadata.entity.SearchRetriever;
 import com.linkedin.metadata.models.EntitySpec;
+import com.linkedin.metadata.models.StructuredPropertyUtils;
 import com.linkedin.metadata.query.filter.Condition;
 import com.linkedin.metadata.query.filter.ConjunctiveCriterion;
 import com.linkedin.metadata.query.filter.ConjunctiveCriterionArray;
@@ -28,6 +38,8 @@
 import com.linkedin.metadata.search.elasticsearch.query.filter.QueryFilterRewriteChain;
 import com.linkedin.metadata.search.elasticsearch.query.request.SearchRequestHandler;
 import io.datahubproject.metadata.context.OperationContext;
+import io.datahubproject.metadata.context.RetrieverContext;
+import io.datahubproject.test.metadata.context.TestOperationContexts;
 import io.datahubproject.test.search.config.SearchCommonTestConfiguration;
 import java.util.ArrayList;
 import java.util.Collection;
@@ -633,6 +645,49 @@ public void testBrowsePathQueryFilter() {
     assertEquals(((ExistsQueryBuilder) mustHaveV1.must().get(0)).fieldName(), "browsePaths");
   }
 
+  @Test(expectedExceptions = IllegalArgumentException.class)
+  public void testInvalidStructuredProperty() {
+    AspectRetriever aspectRetriever = mock(AspectRetriever.class);
+    Map<Urn, Map<String, Aspect>> aspectResponse = new HashMap<>();
+    DataMap statusData = new DataMap();
+    statusData.put("removed", true);
+    Aspect status = new Aspect(statusData);
+    Urn structPropUrn = StructuredPropertyUtils.toURNFromFQN("under.scores.and.dots.make_a_mess");
+    aspectResponse.put(structPropUrn, ImmutableMap.of(STATUS_ASPECT_NAME, status));
+    when(aspectRetriever.getLatestAspectObjects(
+            Collections.singleton(structPropUrn), ImmutableSet.of(STATUS_ASPECT_NAME)))
+        .thenReturn(aspectResponse);
+    OperationContext mockRetrieverContext =
+        TestOperationContexts.systemContextNoSearchAuthorization(
+            RetrieverContext.builder()
+                .aspectRetriever(aspectRetriever)
+                .graphRetriever(mock(GraphRetriever.class))
+                .searchRetriever(mock(SearchRetriever.class))
+                .build());
+
+    Criterion structuredPropCriterion =
+        buildExistsCriterion("structuredProperties.under.scores.and.dots.make_a_mess");
+
+    CriterionArray criterionArray = new CriterionArray();
+    criterionArray.add(structuredPropCriterion);
+
+    ConjunctiveCriterion conjunctiveCriterion = new ConjunctiveCriterion();
+    conjunctiveCriterion.setAnd(criterionArray);
+
+    ConjunctiveCriterionArray conjunctiveCriterionArray = new ConjunctiveCriterionArray();
+    conjunctiveCriterionArray.add(conjunctiveCriterion);
+
+    Filter filter = new Filter();
+    filter.setOr(conjunctiveCriterionArray);
+
+    BoolQueryBuilder test =
+        SearchRequestHandler.getFilterQuery(
+            mockRetrieverContext.withSearchFlags(flags -> flags.setFulltext(false)),
+            filter,
+            new HashMap<>(),
+            QueryFilterRewriteChain.EMPTY);
+  }
+
   @Test
   public void testQueryByDefault() {
     final Set<String> COMMON =
diff --git a/metadata-io/src/test/java/com/linkedin/metadata/search/utils/ESUtilsTest.java b/metadata-io/src/test/java/com/linkedin/metadata/search/utils/ESUtilsTest.java
index 6665faacae337..892f7088e7f61 100644
--- a/metadata-io/src/test/java/com/linkedin/metadata/search/utils/ESUtilsTest.java
+++ b/metadata-io/src/test/java/com/linkedin/metadata/search/utils/ESUtilsTest.java
@@ -43,6 +43,8 @@ public class ESUtilsTest {
   @BeforeClass
   public static void setup() throws RemoteInvocationException, URISyntaxException {
     Urn abFghTenUrn = Urn.createFromString("urn:li:structuredProperty:ab.fgh.ten");
+    Urn underscoresAndDotsUrn =
+        Urn.createFromString("urn:li:structuredProperty:under.scores.and.dots_make_a_mess");
 
     // legacy
     aspectRetriever = mock(AspectRetriever.class);
@@ -62,6 +64,20 @@ public static void setup() throws RemoteInvocationException, URISyntaxException
                     STRUCTURED_PROPERTY_DEFINITION_ASPECT_NAME,
                     new Aspect(structPropAbFghTenDefinition.data()))));
 
+    StructuredPropertyDefinition structPropUnderscoresAndDotsDefinition =
+        new StructuredPropertyDefinition();
+    structPropUnderscoresAndDotsDefinition.setVersion(null, SetMode.REMOVE_IF_NULL);
+    structPropUnderscoresAndDotsDefinition.setValueType(
+        Urn.createFromString(DATA_TYPE_URN_PREFIX + "string"));
+    structPropUnderscoresAndDotsDefinition.setQualifiedName("under.scores.and.dots_make_a_mess");
+    when(aspectRetriever.getLatestAspectObjects(eq(Set.of(underscoresAndDotsUrn)), anySet()))
+        .thenReturn(
+            Map.of(
+                underscoresAndDotsUrn,
+                Map.of(
+                    STRUCTURED_PROPERTY_DEFINITION_ASPECT_NAME,
+                    new Aspect(structPropUnderscoresAndDotsDefinition.data()))));
+
     // V1
     aspectRetrieverV1 = mock(AspectRetriever.class);
     when(aspectRetrieverV1.getEntityRegistry())
@@ -80,6 +96,20 @@ public static void setup() throws RemoteInvocationException, URISyntaxException
                 Map.of(
                     STRUCTURED_PROPERTY_DEFINITION_ASPECT_NAME,
                     new Aspect(structPropAbFghTenDefinitionV1.data()))));
+
+    StructuredPropertyDefinition structPropUnderscoresAndDotsDefinitionV1 =
+        new StructuredPropertyDefinition();
+    structPropUnderscoresAndDotsDefinitionV1.setVersion("00000000000001");
+    structPropUnderscoresAndDotsDefinitionV1.setValueType(
+        Urn.createFromString(DATA_TYPE_URN_PREFIX + "string"));
+    structPropUnderscoresAndDotsDefinitionV1.setQualifiedName("under.scores.and.dots_make_a_mess");
+    when(aspectRetrieverV1.getLatestAspectObjects(eq(Set.of(underscoresAndDotsUrn)), anySet()))
+        .thenReturn(
+            Map.of(
+                underscoresAndDotsUrn,
+                Map.of(
+                    STRUCTURED_PROPERTY_DEFINITION_ASPECT_NAME,
+                    new Aspect(structPropUnderscoresAndDotsDefinitionV1.data()))));
   }
 
   @Test
@@ -703,6 +733,31 @@ public void testGetQueryBuilderFromStructPropEqualsValue() {
     Assert.assertEquals(result.toString(), expected);
   }
 
+  @Test
+  public void testGetQueryBuilderFromNamespacedStructPropEqualsValue() {
+
+    final Criterion singleValueCriterion =
+        buildCriterion(
+            "structuredProperties.under.scores.and.dots_make_a_mess", Condition.EQUAL, "value1");
+
+    OperationContext opContext = mock(OperationContext.class);
+    when(opContext.getAspectRetriever()).thenReturn(aspectRetriever);
+    QueryBuilder result =
+        ESUtils.getQueryBuilderFromCriterion(
+            singleValueCriterion, false, new HashMap<>(), opContext, QueryFilterRewriteChain.EMPTY);
+    String expected =
+        "{\n"
+            + "  \"terms\" : {\n"
+            + "    \"structuredProperties.under_scores_and_dots_make_a_mess.keyword\" : [\n"
+            + "      \"value1\"\n"
+            + "    ],\n"
+            + "    \"boost\" : 1.0,\n"
+            + "    \"_name\" : \"structuredProperties.under.scores.and.dots_make_a_mess\"\n"
+            + "  }\n"
+            + "}";
+    Assert.assertEquals(result.toString(), expected);
+  }
+
   @Test
   public void testGetQueryBuilderFromStructPropEqualsValueV1() {
 
@@ -731,6 +786,35 @@ public void testGetQueryBuilderFromStructPropEqualsValueV1() {
     Assert.assertEquals(result.toString(), expected);
   }
 
+  @Test
+  public void testGetQueryBuilderFromNamespacedStructPropEqualsValueV1() {
+
+    final Criterion singleValueCriterion =
+        buildCriterion(
+            "structuredProperties.under.scores.and.dots_make_a_mess", Condition.EQUAL, "value1");
+
+    OperationContext opContextV1 = mock(OperationContext.class);
+    when(opContextV1.getAspectRetriever()).thenReturn(aspectRetrieverV1);
+    QueryBuilder result =
+        ESUtils.getQueryBuilderFromCriterion(
+            singleValueCriterion,
+            false,
+            new HashMap<>(),
+            opContextV1,
+            QueryFilterRewriteChain.EMPTY);
+    String expected =
+        "{\n"
+            + "  \"terms\" : {\n"
+            + "    \"structuredProperties._versioned.under_scores_and_dots_make_a_mess.00000000000001.string.keyword\" : [\n"
+            + "      \"value1\"\n"
+            + "    ],\n"
+            + "    \"boost\" : 1.0,\n"
+            + "    \"_name\" : \"structuredProperties.under.scores.and.dots_make_a_mess\"\n"
+            + "  }\n"
+            + "}";
+    Assert.assertEquals(result.toString(), expected);
+  }
+
   @Test
   public void testGetQueryBuilderFromStructPropExists() {
     final Criterion singleValueCriterion = buildExistsCriterion("structuredProperties.ab.fgh.ten");
diff --git a/smoke-test/tests/structured_properties/test_structured_properties.py b/smoke-test/tests/structured_properties/test_structured_properties.py
index 8b6fead789b3f..f0509aad77625 100644
--- a/smoke-test/tests/structured_properties/test_structured_properties.py
+++ b/smoke-test/tests/structured_properties/test_structured_properties.py
@@ -165,13 +165,13 @@ def get_property_from_entity(
     return None
 
 
-def to_es_name(property_name=None, namespace=default_namespace, qualified_name=None):
+def to_es_filter_name(
+    property_name=None, namespace=default_namespace, qualified_name=None
+):
     if property_name:
-        namespace_field = namespace.replace(".", "_")
-        return f"structuredProperties.{namespace_field}_{property_name}"
+        return f"structuredProperties.{namespace}.{property_name}"
     else:
-        escaped_qualified_name = qualified_name.replace(".", "_")
-        return f"structuredProperties.{escaped_qualified_name}"
+        return f"structuredProperties.{qualified_name}"
 
 
 # @tenacity.retry(
@@ -446,7 +446,7 @@ def test_structured_property_search(
         graph_client.get_urns_by_filter(
             extraFilters=[
                 {
-                    "field": to_es_name(dataset_property_name),
+                    "field": to_es_filter_name(dataset_property_name),
                     "negated": "false",
                     "condition": "EXISTS",
                 }
@@ -475,7 +475,7 @@ def test_structured_property_search(
             entity_types=["tag"],
             extraFilters=[
                 {
-                    "field": to_es_name(
+                    "field": to_es_filter_name(
                         field_property_name, namespace="io.datahubproject.test"
                     ),
                     "negated": "false",
@@ -492,7 +492,7 @@ def test_structured_property_search(
             entity_types=["dataset", "tag"],
             extraFilters=[
                 {
-                    "field": to_es_name(dataset_property_name),
+                    "field": to_es_filter_name(dataset_property_name),
                     "negated": "false",
                     "condition": "EXISTS",
                 }
@@ -690,7 +690,7 @@ def test_dataset_structured_property_soft_delete_search_filter_validation(
         graph_client.get_urns_by_filter(
             extraFilters=[
                 {
-                    "field": to_es_name(dataset_property_name),
+                    "field": to_es_filter_name(property_name=dataset_property_name),
                     "negated": "false",
                     "condition": "EXISTS",
                 }
@@ -710,7 +710,7 @@ def test_dataset_structured_property_soft_delete_search_filter_validation(
             graph_client.get_urns_by_filter(
                 extraFilters=[
                     {
-                        "field": to_es_name(dataset_property_name),
+                        "field": to_es_filter_name(property_name=dataset_property_name),
                         "negated": "false",
                         "condition": "EXISTS",
                     }
@@ -779,7 +779,7 @@ def validate_search(qualified_name, expected):
             graph_client.get_urns_by_filter(
                 extraFilters=[
                     {
-                        "field": to_es_name(qualified_name=qualified_name),
+                        "field": to_es_filter_name(qualified_name=qualified_name),
                         "negated": "false",
                         "condition": "EXISTS",
                     }

From 5c0377a761a2f251d3a48b909b92b984a5d2fbd6 Mon Sep 17 00:00:00 2001
From: John Joyce <john@acryl.io>
Date: Wed, 30 Oct 2024 14:53:38 -0700
Subject: [PATCH 06/21] feat(ui): Support markdown for incident descriptions
 (#11759)

Co-authored-by: John Joyce <john@ip-192-168-1-200.us-west-2.compute.internal>
---
 .../Incident/components/AddIncidentModal.tsx  | 21 +++++++++++++++++--
 .../Incident/components/IncidentListItem.tsx  |  3 ++-
 2 files changed, 21 insertions(+), 3 deletions(-)

diff --git a/datahub-web-react/src/app/entity/shared/tabs/Incident/components/AddIncidentModal.tsx b/datahub-web-react/src/app/entity/shared/tabs/Incident/components/AddIncidentModal.tsx
index fda8c9cda2d0d..663575f062093 100644
--- a/datahub-web-react/src/app/entity/shared/tabs/Incident/components/AddIncidentModal.tsx
+++ b/datahub-web-react/src/app/entity/shared/tabs/Incident/components/AddIncidentModal.tsx
@@ -1,7 +1,7 @@
 import React, { useState } from 'react';
 import { message, Modal, Button, Form, Input, Typography, Select } from 'antd';
 import { useApolloClient } from '@apollo/client';
-import TextArea from 'antd/lib/input/TextArea';
+import styled from 'styled-components';
 import analytics, { EventType, EntityActionType } from '../../../../../analytics';
 import { useEntityData } from '../../../EntityContext';
 import { EntityType, IncidentSourceType, IncidentState, IncidentType } from '../../../../../../types.generated';
@@ -9,6 +9,12 @@ import { INCIDENT_DISPLAY_TYPES, PAGE_SIZE, addActiveIncidentToCache } from '../
 import { useRaiseIncidentMutation } from '../../../../../../graphql/mutations.generated';
 import handleGraphQLError from '../../../../../shared/handleGraphQLError';
 import { useUserContext } from '../../../../../context/useUserContext';
+import { Editor } from '../../Documentation/components/editor/Editor';
+import { ANTD_GRAY } from '../../../constants';
+
+const StyledEditor = styled(Editor)`
+    border: 1px solid ${ANTD_GRAY[4.5]};
+`;
 
 type AddIncidentProps = {
     open: boolean;
@@ -112,6 +118,7 @@ export const AddIncidentModal = ({ open, onClose, refetch }: AddIncidentProps) =
                 open={open}
                 destroyOnClose
                 onCancel={handleClose}
+                width={600}
                 footer={[
                     <Button type="text" onClick={handleClose}>
                         Cancel
@@ -174,7 +181,17 @@ export const AddIncidentModal = ({ open, onClose, refetch }: AddIncidentProps) =
                             },
                         ]}
                     >
-                        <TextArea placeholder="Provide some additional details" />
+                        <StyledEditor
+                            doNotFocus
+                            className="add-incident-description"
+                            onKeyDown={(e) => {
+                                // Preventing the modal from closing when the Enter key is pressed
+                                if (e.key === 'Enter') {
+                                    e.preventDefault();
+                                    e.stopPropagation();
+                                }
+                            }}
+                        />
                     </Form.Item>
                 </Form>
             </Modal>
diff --git a/datahub-web-react/src/app/entity/shared/tabs/Incident/components/IncidentListItem.tsx b/datahub-web-react/src/app/entity/shared/tabs/Incident/components/IncidentListItem.tsx
index dc123398cd2da..3438003c2f17b 100644
--- a/datahub-web-react/src/app/entity/shared/tabs/Incident/components/IncidentListItem.tsx
+++ b/datahub-web-react/src/app/entity/shared/tabs/Incident/components/IncidentListItem.tsx
@@ -14,6 +14,7 @@ import { useUpdateIncidentStatusMutation } from '../../../../../../graphql/mutat
 import { ResolveIncidentModal } from './ResolveIncidentModal';
 import handleGraphQLError from '../../../../../shared/handleGraphQLError';
 import { MenuItemStyle } from '../../../../view/menu/item/styledComponent';
+import MarkdownViewer from '../../../components/legacy/MarkdownViewer';
 
 type Props = {
     incident: any;
@@ -227,7 +228,7 @@ export default function IncidentListItem({ incident, refetch }: Props) {
                             </TitleContainer>
                             <DescriptionContainer>
                                 <IncidentDescriptionLabel>Description</IncidentDescriptionLabel>
-                                <IncidentDescriptionText>{incident?.description}</IncidentDescriptionText>
+                                <MarkdownViewer source={incident?.description} />
                                 {incident.status.state === IncidentState.Resolved ? (
                                     <>
                                         <IncidentDescriptionLabel>Resolution Note</IncidentDescriptionLabel>

From 94bcb79b8462738b3144d3800731c0c7066bad4c Mon Sep 17 00:00:00 2001
From: noggi <anton.kuraev@acryl.io>
Date: Thu, 31 Oct 2024 10:59:21 -0700
Subject: [PATCH 07/21] feat(ingestion): Add execution request cleanup job
 (#11765)

---
 .../bootstrapmcp/datahub-test-mcp.yaml        |   8 +-
 .../docs/sources/gc/gc_recipe.dhub.yml        |  11 +
 .../datahub/ingestion/source/gc/datahub_gc.py |  25 +-
 .../source/gc/execution_request_cleanup.py    | 240 ++++++++++++++++++
 .../src/main/resources/bootstrap_mcps.yaml    |   4 +-
 .../bootstrap_mcps/ingestion-datahub-gc.yaml  |   8 +-
 6 files changed, 291 insertions(+), 5 deletions(-)
 create mode 100644 metadata-ingestion/src/datahub/ingestion/source/gc/execution_request_cleanup.py

diff --git a/datahub-upgrade/src/test/resources/bootstrapmcp/datahub-test-mcp.yaml b/datahub-upgrade/src/test/resources/bootstrapmcp/datahub-test-mcp.yaml
index d049a807ac1d8..233db06d61c3f 100644
--- a/datahub-upgrade/src/test/resources/bootstrapmcp/datahub-test-mcp.yaml
+++ b/datahub-upgrade/src/test/resources/bootstrapmcp/datahub-test-mcp.yaml
@@ -23,7 +23,13 @@
               keep_last_n: {{dataprocess_cleanup.keep_last_n}}{{^dataprocess_cleanup.keep_last_n}}5{{/dataprocess_cleanup.keep_last_n}}
             soft_deleted_entities_cleanup:
               retention_days: {{soft_deleted_entities_cleanup.retention_days}}{{^soft_deleted_entities_cleanup.retention_days}}10{{/soft_deleted_entities_cleanup.retention_days}}
+            execution_request_cleanup:
+              keep_history_min_count: {{execution_request_cleanup.keep_history_min_count}}{{^execution_request_cleanup.keep_history_min_count}}10{{/execution_request_cleanup.keep_history_min_count}}
+              keep_history_max_count: {{execution_request_cleanup.keep_history_max_count}}{{^execution_request_cleanup.keep_history_max_count}}1000{{/execution_request_cleanup.keep_history_max_count}}
+              keep_history_max_days: {{execution_request_cleanup.keep_history_max_days}}{{^execution_request_cleanup.keep_history_max_days}}30{{/execution_request_cleanup.keep_history_max_days}}
+              batch_read_size: {{execution_request_cleanup.batch_read_size}}{{^execution_request_cleanup.batch_read_size}}100{{/execution_request_cleanup.batch_read_size}}
+              enabled: {{execution_request_cleanup.enabled}}{{^execution_request_cleanup.enabled}}false{{/execution_request_cleanup.enabled}}
       extraArgs: {}
       debugMode: false
       executorId: default
-  headers: {}
\ No newline at end of file
+  headers: {}
diff --git a/metadata-ingestion/docs/sources/gc/gc_recipe.dhub.yml b/metadata-ingestion/docs/sources/gc/gc_recipe.dhub.yml
index 21734cd4e03fa..05e5205f7da41 100644
--- a/metadata-ingestion/docs/sources/gc/gc_recipe.dhub.yml
+++ b/metadata-ingestion/docs/sources/gc/gc_recipe.dhub.yml
@@ -22,3 +22,14 @@ source:
     soft_deleted_entities_cleanup:
       # Delete soft deleted entities which were deleted 10 days ago
       retention_days: 10
+    execution_request_cleanup:
+      # Minimum number of execution requests to keep, per ingestion source
+      keep_history_min_count: 10
+      # Maximum number of execution requests to keep, per ingestion source
+      keep_history_max_count: 1000
+      # Maximum number of days to keep execution requests for, per ingestion source
+      keep_history_max_days: 30
+      # Number of records per read operation
+      batch_read_size: 100
+      # Global switch for this cleanup task 
+      enabled: true
diff --git a/metadata-ingestion/src/datahub/ingestion/source/gc/datahub_gc.py b/metadata-ingestion/src/datahub/ingestion/source/gc/datahub_gc.py
index 1897f3f288ec0..c4b4186f45fc3 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/gc/datahub_gc.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/gc/datahub_gc.py
@@ -24,6 +24,11 @@
     DataProcessCleanupConfig,
     DataProcessCleanupReport,
 )
+from datahub.ingestion.source.gc.execution_request_cleanup import (
+    DatahubExecutionRequestCleanup,
+    DatahubExecutionRequestCleanupConfig,
+    DatahubExecutionRequestCleanupReport,
+)
 from datahub.ingestion.source.gc.soft_deleted_entity_cleanup import (
     SoftDeletedEntitiesCleanup,
     SoftDeletedEntitiesCleanupConfig,
@@ -70,9 +75,18 @@ class DataHubGcSourceConfig(ConfigModel):
         description="Configuration for soft deleted entities cleanup",
     )
 
+    execution_request_cleanup: Optional[DatahubExecutionRequestCleanupConfig] = Field(
+        default=None,
+        description="Configuration for execution request cleanup",
+    )
+
 
 @dataclass
-class DataHubGcSourceReport(DataProcessCleanupReport, SoftDeletedEntitiesReport):
+class DataHubGcSourceReport(
+    DataProcessCleanupReport,
+    SoftDeletedEntitiesReport,
+    DatahubExecutionRequestCleanupReport,
+):
     expired_tokens_revoked: int = 0
 
 
@@ -97,6 +111,7 @@ def __init__(self, ctx: PipelineContext, config: DataHubGcSourceConfig):
         self.graph = ctx.require_graph("The DataHubGc source")
         self.dataprocess_cleanup: Optional[DataProcessCleanup] = None
         self.soft_deleted_entities_cleanup: Optional[SoftDeletedEntitiesCleanup] = None
+        self.execution_request_cleanup: Optional[DatahubExecutionRequestCleanup] = None
 
         if self.config.dataprocess_cleanup:
             self.dataprocess_cleanup = DataProcessCleanup(
@@ -109,6 +124,12 @@ def __init__(self, ctx: PipelineContext, config: DataHubGcSourceConfig):
                 self.report,
                 self.config.dry_run,
             )
+        if self.config.execution_request_cleanup:
+            self.execution_request_cleanup = DatahubExecutionRequestCleanup(
+                config=self.config.execution_request_cleanup,
+                graph=self.graph,
+                report=self.report,
+            )
 
     @classmethod
     def create(cls, config_dict, ctx):
@@ -130,6 +151,8 @@ def get_workunits_internal(
             yield from self.dataprocess_cleanup.get_workunits_internal()
         if self.soft_deleted_entities_cleanup:
             self.soft_deleted_entities_cleanup.cleanup_soft_deleted_entities()
+        if self.execution_request_cleanup:
+            self.execution_request_cleanup.run()
         yield from []
 
     def truncate_indices(self) -> None:
diff --git a/metadata-ingestion/src/datahub/ingestion/source/gc/execution_request_cleanup.py b/metadata-ingestion/src/datahub/ingestion/source/gc/execution_request_cleanup.py
new file mode 100644
index 0000000000000..570df4e99ab13
--- /dev/null
+++ b/metadata-ingestion/src/datahub/ingestion/source/gc/execution_request_cleanup.py
@@ -0,0 +1,240 @@
+import logging
+import time
+from typing import Any, Dict, Iterator, Optional
+
+from pydantic import BaseModel, Field
+
+from datahub.configuration.common import ConfigModel
+from datahub.ingestion.api.source import SourceReport
+from datahub.ingestion.graph.client import DataHubGraph
+
+logger = logging.getLogger(__name__)
+
+DATAHUB_EXECUTION_REQUEST_ENTITY_NAME = "dataHubExecutionRequest"
+DATAHUB_EXECUTION_REQUEST_KEY_ASPECT_NAME = "dataHubExecutionRequestKey"
+DATAHUB_EXECUTION_REQUEST_INPUT_ASPECT_NAME = "dataHubExecutionRequestInput"
+DATAHUB_EXECUTION_REQUEST_RESULT_ASPECT_NAME = "dataHubExecutionRequestResult"
+
+
+class DatahubExecutionRequestCleanupConfig(ConfigModel):
+    keep_history_min_count: int = Field(
+        10,
+        description="Minimum number of execution requests to keep, per ingestion source",
+    )
+
+    keep_history_max_count: int = Field(
+        1000,
+        description="Maximum number of execution requests to keep, per ingestion source",
+    )
+
+    keep_history_max_days: int = Field(
+        30,
+        description="Maximum number of days to keep execution requests for, per ingestion source",
+    )
+
+    batch_read_size: int = Field(
+        100,
+        description="Number of records per read operation",
+    )
+
+    enabled: bool = Field(
+        True,
+        description="Global switch for this cleanup task",
+    )
+
+    def keep_history_max_milliseconds(self):
+        return self.keep_history_max_days * 24 * 3600 * 1000
+
+
+class DatahubExecutionRequestCleanupReport(SourceReport):
+    execution_request_cleanup_records_read: int = 0
+    execution_request_cleanup_records_preserved: int = 0
+    execution_request_cleanup_records_deleted: int = 0
+    execution_request_cleanup_read_errors: int = 0
+    execution_request_cleanup_delete_errors: int = 0
+
+
+class CleanupRecord(BaseModel):
+    urn: str
+    request_id: str
+    status: str
+    ingestion_source: str
+    requested_at: int
+
+
+class DatahubExecutionRequestCleanup:
+    def __init__(
+        self,
+        graph: DataHubGraph,
+        report: DatahubExecutionRequestCleanupReport,
+        config: Optional[DatahubExecutionRequestCleanupConfig] = None,
+    ) -> None:
+
+        self.graph = graph
+        self.report = report
+        self.instance_id = int(time.time())
+
+        if config is not None:
+            self.config = config
+        else:
+            self.config = DatahubExecutionRequestCleanupConfig()
+
+    def _to_cleanup_record(self, entry: Dict) -> CleanupRecord:
+        input_aspect = (
+            entry.get("aspects", {})
+            .get(DATAHUB_EXECUTION_REQUEST_INPUT_ASPECT_NAME, {})
+            .get("value", {})
+        )
+        result_aspect = (
+            entry.get("aspects", {})
+            .get(DATAHUB_EXECUTION_REQUEST_RESULT_ASPECT_NAME, {})
+            .get("value", {})
+        )
+        key_aspect = (
+            entry.get("aspects", {})
+            .get(DATAHUB_EXECUTION_REQUEST_KEY_ASPECT_NAME, {})
+            .get("value", {})
+        )
+        return CleanupRecord(
+            urn=entry.get("urn"),
+            request_id=key_aspect.get("id"),
+            requested_at=input_aspect.get("requestedAt", 0),
+            status=result_aspect.get("status", "PENDING"),
+            ingestion_source=input_aspect.get("source", {}).get("ingestionSource", ""),
+        )
+
+    def _scroll_execution_requests(
+        self, overrides: Dict[str, Any] = {}
+    ) -> Iterator[CleanupRecord]:
+        headers: Dict[str, Any] = {
+            "Accept": "application/json",
+            "Content-Type": "application/json",
+        }
+        params = {
+            "aspectNames": [
+                DATAHUB_EXECUTION_REQUEST_KEY_ASPECT_NAME,
+                DATAHUB_EXECUTION_REQUEST_INPUT_ASPECT_NAME,
+                DATAHUB_EXECUTION_REQUEST_RESULT_ASPECT_NAME,
+            ],
+            "count": str(self.config.batch_read_size),
+            "sort": "requestTimeMs",
+            "sortOrder": "DESCENDING",
+            "systemMetadata": "false",
+            "skipCache": "true",
+        }
+        params.update(overrides)
+
+        while True:
+            try:
+                url = f"{self.graph.config.server}/openapi/v2/entity/{DATAHUB_EXECUTION_REQUEST_ENTITY_NAME}"
+                response = self.graph._session.get(url, headers=headers, params=params)
+                response.raise_for_status()
+                document = response.json()
+
+                entries = document.get("results", [])
+                for entry in entries:
+                    yield self._to_cleanup_record(entry)
+
+                if "scrollId" not in document:
+                    break
+                params["scrollId"] = document["scrollId"]
+            except Exception as e:
+                logger.error(
+                    f"ergc({self.instance_id}): failed to fetch next batch of execution requests: {e}"
+                )
+                self.report.execution_request_cleanup_read_errors += 1
+
+    def _scroll_garbage_records(self):
+        state: Dict[str, Dict] = {}
+
+        now_ms = int(time.time()) * 1000
+        running_guard_timeout = now_ms - 30 * 24 * 3600 * 1000
+
+        for entry in self._scroll_execution_requests():
+            self.report.execution_request_cleanup_records_read += 1
+            key = entry.ingestion_source
+
+            # Always delete corrupted records
+            if not key:
+                logger.warning(
+                    f"ergc({self.instance_id}): will delete corrupted entry with missing source key: {entry}"
+                )
+                yield entry
+                continue
+
+            if key not in state:
+                state[key] = {}
+                state[key]["cutoffTimestamp"] = (
+                    entry.requested_at - self.config.keep_history_max_milliseconds()
+                )
+
+            state[key]["count"] = state[key].get("count", 0) + 1
+
+            # Do not delete if number of requests is below minimum
+            if state[key]["count"] < self.config.keep_history_min_count:
+                self.report.execution_request_cleanup_records_preserved += 1
+                continue
+
+            # Do not delete if number of requests do not exceed allowed maximum,
+            # or the cutoff date.
+            if (state[key]["count"] < self.config.keep_history_max_count) and (
+                entry.requested_at > state[key]["cutoffTimestamp"]
+            ):
+                self.report.execution_request_cleanup_records_preserved += 1
+                continue
+
+            # Do not delete if status is RUNNING or PENDING and created within last month. If the record is >month old and it did not
+            # transition to a final state within that timeframe, it likely has no value.
+            if entry.requested_at > running_guard_timeout and entry.status in [
+                "RUNNING",
+                "PENDING",
+            ]:
+                self.report.execution_request_cleanup_records_preserved += 1
+                continue
+
+            # Otherwise delete current record
+            logger.info(
+                (
+                    f"ergc({self.instance_id}): going to delete {entry.request_id} in source {key}; "
+                    f"source count: {state[key]['count']}; "
+                    f"source cutoff: {state[key]['cutoffTimestamp']}; "
+                    f"record timestamp: {entry.requested_at}."
+                )
+            )
+            self.report.execution_request_cleanup_records_deleted += 1
+            yield entry
+
+    def _delete_entry(self, entry: CleanupRecord) -> None:
+        try:
+            logger.info(
+                f"ergc({self.instance_id}): going to delete ExecutionRequest {entry.request_id}"
+            )
+            self.graph.delete_entity(entry.urn, True)
+        except Exception as e:
+            self.report.execution_request_cleanup_delete_errors += 1
+            logger.error(
+                f"ergc({self.instance_id}): failed to delete ExecutionRequest {entry.request_id}: {e}"
+            )
+
+    def run(self) -> None:
+        if not self.config.enabled:
+            logger.info(
+                f"ergc({self.instance_id}): ExecutionRequest cleaner is disabled."
+            )
+            return
+
+        logger.info(
+            (
+                f"ergc({self.instance_id}): Starting cleanup of ExecutionRequest records; "
+                f"max days: {self.config.keep_history_max_days}, "
+                f"min records: {self.config.keep_history_min_count}, "
+                f"max records: {self.config.keep_history_max_count}."
+            )
+        )
+
+        for entry in self._scroll_garbage_records():
+            self._delete_entry(entry)
+
+        logger.info(
+            f"ergc({self.instance_id}): Finished cleanup of ExecutionRequest records."
+        )
diff --git a/metadata-service/configuration/src/main/resources/bootstrap_mcps.yaml b/metadata-service/configuration/src/main/resources/bootstrap_mcps.yaml
index 10ae176b2c31e..dda79120118e5 100644
--- a/metadata-service/configuration/src/main/resources/bootstrap_mcps.yaml
+++ b/metadata-service/configuration/src/main/resources/bootstrap_mcps.yaml
@@ -38,7 +38,7 @@ bootstrap:
 
     # Ingestion Recipes
     - name: ingestion-datahub-gc
-      version: v1
+      version: v2
       optional: true
       mcps_location: "bootstrap_mcps/ingestion-datahub-gc.yaml"
-      values_env: "DATAHUB_GC_BOOTSTRAP_VALUES"
\ No newline at end of file
+      values_env: "DATAHUB_GC_BOOTSTRAP_VALUES"
diff --git a/metadata-service/configuration/src/main/resources/bootstrap_mcps/ingestion-datahub-gc.yaml b/metadata-service/configuration/src/main/resources/bootstrap_mcps/ingestion-datahub-gc.yaml
index e70ab1162a381..f30ce148ec6cb 100644
--- a/metadata-service/configuration/src/main/resources/bootstrap_mcps/ingestion-datahub-gc.yaml
+++ b/metadata-service/configuration/src/main/resources/bootstrap_mcps/ingestion-datahub-gc.yaml
@@ -27,7 +27,13 @@
               keep_last_n: {{dataprocess_cleanup.keep_last_n}}{{^dataprocess_cleanup.keep_last_n}}5{{/dataprocess_cleanup.keep_last_n}}
             soft_deleted_entities_cleanup:
               retention_days: {{soft_deleted_entities_cleanup.retention_days}}{{^soft_deleted_entities_cleanup.retention_days}}10{{/soft_deleted_entities_cleanup.retention_days}}
-      extraArgs: {}
+            execution_request_cleanup:
+              keep_history_min_count: {{execution_request_cleanup.keep_history_min_count}}{{^execution_request_cleanup.keep_history_min_count}}10{{/execution_request_cleanup.keep_history_min_count}}
+              keep_history_max_count: {{execution_request_cleanup.keep_history_max_count}}{{^execution_request_cleanup.keep_history_max_count}}1000{{/execution_request_cleanup.keep_history_max_count}}
+              keep_history_max_days: {{execution_request_cleanup.keep_history_max_days}}{{^execution_request_cleanup.keep_history_max_days}}30{{/execution_request_cleanup.keep_history_max_days}}
+              batch_read_size: {{execution_request_cleanup.batch_read_size}}{{^execution_request_cleanup.batch_read_size}}100{{/execution_request_cleanup.batch_read_size}}
+              enabled: {{execution_request_cleanup.enabled}}{{^execution_request_cleanup.enabled}}false{{/execution_request_cleanup.enabled}}
+    extraArgs: {}
       debugMode: false
       executorId: default
     source:

From e36bdc6495695c2b19e8b53dc0da1af1a6aa6eac Mon Sep 17 00:00:00 2001
From: Jay <159848059+jayacryl@users.noreply.github.com>
Date: Thu, 31 Oct 2024 14:43:38 -0400
Subject: [PATCH 08/21] feat(docs-site) polishes and improved responsiveness
 for the home and solutions pages (#11770)

---
 .../Community/community.module.scss           |   4 ++--
 .../quickstartcontent.module.scss             |   2 +-
 .../_components/Integrations/index.js         |   1 +
 .../Integrations/integrations.module.scss     |   7 ++++++
 .../_components/IntegrationsStatic/index.js   |   2 +-
 .../integrations.module.scss                  |  21 ++++++++++++------
 .../logo-integration-5.png                    | Bin 2329 -> 2999 bytes
 .../logo-integration-6.png                    | Bin 1415 -> 3800 bytes
 .../logo-integration-7.png                    | Bin 0 -> 2329 bytes
 .../logo-integration-8.png                    | Bin 0 -> 1415 bytes
 10 files changed, 26 insertions(+), 11 deletions(-)
 create mode 100644 docs-website/static/img/solutions/integrations-observe/logo-integration-7.png
 create mode 100644 docs-website/static/img/solutions/integrations-observe/logo-integration-8.png

diff --git a/docs-website/src/pages/_components/Community/community.module.scss b/docs-website/src/pages/_components/Community/community.module.scss
index 62f0dc13b110a..65da50435597d 100644
--- a/docs-website/src/pages/_components/Community/community.module.scss
+++ b/docs-website/src/pages/_components/Community/community.module.scss
@@ -221,14 +221,14 @@
 
 .numberContainer {
   display: inline-block;
-  width: 11rem;
+  width: 12rem;
   text-align: right;
 }
 
 .numberChange {
   display: inline-block;
   animation: slideIn 0.5s ease-in-out;
-  width: 11rem;
+  width: 12rem;
 }
 
 
diff --git a/docs-website/src/pages/_components/QuickstartContent/quickstartcontent.module.scss b/docs-website/src/pages/_components/QuickstartContent/quickstartcontent.module.scss
index 1c1f13cbca566..27bdca710b821 100644
--- a/docs-website/src/pages/_components/QuickstartContent/quickstartcontent.module.scss
+++ b/docs-website/src/pages/_components/QuickstartContent/quickstartcontent.module.scss
@@ -129,7 +129,7 @@
 
     .quickstart__content {
       display: flex;
-      margin-bottom: 3rem;
+      margin-bottom: 6rem;
       width: 100%;
 
       .quickstart__text {
diff --git a/docs-website/src/pages/solutions/_components/Integrations/index.js b/docs-website/src/pages/solutions/_components/Integrations/index.js
index 77f028eb4cf74..763c2a185c7dd 100644
--- a/docs-website/src/pages/solutions/_components/Integrations/index.js
+++ b/docs-website/src/pages/solutions/_components/Integrations/index.js
@@ -47,6 +47,7 @@ const Integrations = () => {
               </div>
           </div>
       </div>
+      <a href="/integrations">See all →</a>
     </div>
   );
 };
diff --git a/docs-website/src/pages/solutions/_components/Integrations/integrations.module.scss b/docs-website/src/pages/solutions/_components/Integrations/integrations.module.scss
index da0c6964e8775..07a6a2548e41a 100644
--- a/docs-website/src/pages/solutions/_components/Integrations/integrations.module.scss
+++ b/docs-website/src/pages/solutions/_components/Integrations/integrations.module.scss
@@ -1,6 +1,13 @@
 .container {
   display: flex;
   flex-direction: column;
+  >a {
+    text-decoration: none;
+    text-align: center;
+    margin-top: 1rem;
+    margin-bottom: 1rem;
+    font-size: 1.25rem;
+  }
 
   .section_header {
     color: var(--primitives-text-tex-subtext, #777E99);
diff --git a/docs-website/src/pages/solutions/_components/IntegrationsStatic/index.js b/docs-website/src/pages/solutions/_components/IntegrationsStatic/index.js
index 76b99b156704e..17857f7b0360b 100644
--- a/docs-website/src/pages/solutions/_components/IntegrationsStatic/index.js
+++ b/docs-website/src/pages/solutions/_components/IntegrationsStatic/index.js
@@ -17,7 +17,7 @@ const Integrations = () => {
                 <div className={styles.slide_track}>
                   {[...Array(1)].map((_, i) => (
                     <React.Fragment key={i}>
-                      {[1, 2, 3, 4, 5, 6].map((item, index) => (
+                      {[1, 2, 3, 4, 5, 6, 7, 8].map((item, index) => (
                         <div className={styles.slide} key={index} style={{ backgroundImage: `url(${useBaseUrl(`${integrationsPath}/logo-integration-${item}.png`)})` }}>
                         </div>
                       ))}
diff --git a/docs-website/src/pages/solutions/_components/IntegrationsStatic/integrations.module.scss b/docs-website/src/pages/solutions/_components/IntegrationsStatic/integrations.module.scss
index aa2201fd0185c..a945f4ae0598f 100644
--- a/docs-website/src/pages/solutions/_components/IntegrationsStatic/integrations.module.scss
+++ b/docs-website/src/pages/solutions/_components/IntegrationsStatic/integrations.module.scss
@@ -71,18 +71,22 @@
 
 .slider {
   position: relative;
+  display: flex;
 }
 
 .slide_track {
   display: flex;
-  width: max-content;
+  width: 80%;
   margin: auto;
+  flex-direction: row;
+  align-items: center;
+  justify-content: space-evenly;
 }
 
 .slide {
-  width: 100px;
-  height: 100px;
-  margin: auto 3rem;
+  width: 80px;
+  height: 80px;
+  margin: auto 0;
   display: flex;
   justify-content: space-between;
   overflow: hidden;
@@ -99,9 +103,12 @@
     max-width: 100vw;
     min-width: auto;
   }
+  .slide_track {
+    width: 95%;
+  }
   .slide {
-    width: 80px;
-    height: 80px;
-    margin: auto 1rem;
+    width: 40px;
+    height: 40px;
+    margin: auto 0;
   }
 }
\ No newline at end of file
diff --git a/docs-website/static/img/solutions/integrations-observe/logo-integration-5.png b/docs-website/static/img/solutions/integrations-observe/logo-integration-5.png
index acc17cb75d58560e703a0e19327d6d0e8fa4a8b5..c4d69b1ed3bc198f61a793e35efb28144317ee94 100644
GIT binary patch
delta 2978
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
Y0s2=NJ}H)D3IG5A07*qoM6N<$f{KQ-i2wiq

delta 2303
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
Z4*~T>9P;QXQz!rc002ovPDHLkV1gQ$S2h3u

diff --git a/docs-website/static/img/solutions/integrations-observe/logo-integration-6.png b/docs-website/static/img/solutions/integrations-observe/logo-integration-6.png
index d9bb08766f527311a0dc18ebca1504cc8dd8cfae..c22402e99d1f367fdf2c747c55ff42c63afd5268 100644
GIT binary patch
delta 3786
zcmV;*4mI(I3)meYiBL{Q4GJ0x0000DNk~Le0001U0001U2nGNE0INei=8+*Ze-3R)
zL_t(|0qvcAa1`Yo$G^|+-X#}uG2vaU5Kt5l6cuX)#UNVo9ke=iT6t-;)~W@ot(|r{
zf`7E?Oh?eE<J1?xQSb!?w4kV!pd!VJrXqs884!8b#Jq6H-R?g9{q~Y@d%Kr60=IkY
zXXYlk-RJJYefRe~zqe-*=whUlf5r9niBi*yk3fJ6qFM;0y09?6LI_cfE=1rkVex8e
z>Zd4*auGc%qqi(ZKzkuUWrb;CNl{U^#W+klEoN<Ptc=9FpMEVvKo=m%VzF3Nm6?%9
zq!OK=!(s*^9(l-G=XOTac8kf=X<gmHIrNeV2slcJ8PRBDX1hnXXAoN>e_bteq(mtK
zjw&?uR;sEP+a4=b+8R(-*D#Ijaz!9ycHr;bFyxB5y0)W(RxOh(lGa8!0|8!u93*XQ
zVPUu;(}0X(210t0Rt0qxlj6n+6woe0fahp!4Rx%Uu~@8BQN$w%@Fcv3>bjiccFrLt
z4-A|g&r?=gTR$WHplzD1f2paPLV3eE2=D{dnkLRloo;QGN%__L5#Se!X%@9Dhb>~V
zRR+_m@0h?oPV<u%F$1ggC%SG-Z~om9lhbv9Rr(cWa#fYI%8r(pLYR{g;8%(@t-(t5
zSz?k^23-NZ#;__`N>x=AnWzZF^f44pUdulfP0J62^f~PB@Vco`f1NTAGY81eZzxu{
zg8%`(Cy_8mC_zY)8z>4*vk1r;0x@%lK+GH>5Hp7e#LOWAF>{DO%p4*RGl$TSYnTa$
z+HWDMcR|!wK{V7-Q9%dP5M-nX^0+>bMfB*_-RfJ+C2~Scv41PnEvun@@h+5IUqICC
zg-A3a*{>#(qEV`=fBCu0FNEyg59Ue3p${DgbKv<fqdnkv{3~WW25tRY2(5Y+YURg(
zo^Tl?n|?^!bJ0)-L87zp+L{+33rb)N9gD=MNiYVS>syQUpO|_ap^q0L^zVN_+5Z)~
z0&%bk+Q+X#`(!bUlg~%|@_S(nJP&@uS7ItVKSTb4d!c;ue>si_rU`ZPDnz!fLE?uu
zATj<Pn8hc+FZjcor7t=B_H0BRyZ*=tY5P1Kq5mvE<k1OGH>`kP@VuC!?px%~pN8<#
zhaej3+wp>?^-j@fEi6uYugCRGda&g9K=40Vv};`y-|a-?nOmT2{}g_})6*=67uJ`#
zqoR$0NpZ~Me}}*rG#bXKV_^0k09n|R{)J(3dlZt-1R4*Lr@M!&`wOU>-nTqp<-4yl
zzpttx&Qopwv)~6jE2gO3kI0jg>5E_A${+z5%7bynRfu0Wg+h%HT%~m#YWcBR9>td>
zmgxG(>mkS^R=+GqsQgK&+t#Fby+{gq#UBwL_Z#>He{YJJh$HXCKeQ>NKKwHBJntiM
zPD5vq;RwCQ<<N(Xw_?=r>kmNLv)PwIGM*HZogMA-<r&Y*!X6~z?<p?4xocuVzA#Q7
zM=|C(6!JU{&|2#^AsNq!scu|>@H>xXJa2YC2@SVB53|oH?gJ<eRd#QHQn?oD?oANi
z?}4Bcf1k|j21#LtdE)6X`kzB<>OjX!*<p%b{U`VpPl?I7)Vzg%wn76pOiIBu-1)L4
zsN=Qd^=fMtAoS78luX!0gN>9lUh^PfEuQ+2v2;N^hg`!`Vus#(8p?r6*K-_VG~Dr$
ztB|49&mr{IY$#RVq`gQwpYxPD>SxGBJQHV%f9gHZR?Txisi<h2_yEiv{ha5hBBJct
z;1n_gX3zf6Pb)(%;u$eRYvx0tsnP*iQi3c=A91z&3(50rymkf>V}5})VXGYZ6Y{Vk
z$VI#{%_bV4ee{y+DH-jF#3j>Of4vq$<2A{>!lCz`v7bxzcEbfpF>@48h^b}D#IRM4
zf1XUq?&EETLm$k8QF=Da9}G`<6T6_Yuse)?H0H#i6i*gdR?i-->r|a1ctT9I;&rF9
zLdg6m^z(jdJEk1ij_|UFNU=P`Zhh8OP@U3wa==KK+)Z!{k^ME392oVh|GJ+#ZH%J?
z6@Ggb)gP-Ve%wpxzDZOTTW5a}32F@cfAKLVB$IV9mFjP3irwKn!OqGVm)j53?1j4S
z%|p*K33`l@eK9$}H(ZhgRKhYTQ<I9e=>v#ZjqO;ope*#UPWHv*#J1adS=<+9iQVy0
zHm-CZOQkM$c#d_l?*P^8LrWK33TE+%q+ZB&Ox^pX>sxS#UHaH`*rL_XmO*W;e-e`h
z_XFu?UUBFEmCW)N{RPr69Agt@zk+$f5M-0Ai<z7@-K;IG^-*tZ5<dM6sO;STY_$3r
zl=F=|eq*wv)`2Pu=X-5p(%-4BTW%ds{~L^9mj+@ABkq1ewf|{CPgoB(%!1Z;@@s2f
zIaC{UnWi%mKWKkWX+=p7$K}B9f7y5t*(U32CVx4uq&Y>BI|wp#5eT;0R^T>~PW=}y
zYS{jqDlx(|T>b!Ibuna{?2Ac>0oN}&&1*#{V$~a+Z$MMu?u}^mGx`qdl$Nrnx9z#r
zC7<cS;byTcll`QD72G?gK8`<;Y6ZMD_Hr*sr^cRcB+j{xswJfz>q_9yf1^~O?NIGL
zh`7siN*9z#Ipl1U^)=J%HNaU!CKQSv+0jU~4s+0GVEuB(Sk54E2cOx`{gy`DW*NI{
z5f!dqgpzK>wfn93)qzkbw`=dpQ}%9kUvtCVtai?9lYKF*_77)h!p?`fYd!Q7G4;V?
z5T;}Tj5J4x*4O+O?m_I1e}z`}of~{n#4owad4im(yw_$rsx9X6gJJfy&jiY*_uVED
zs}LYPkUq@%G;8)KwYmr#kOe6Jd&54q&mb75jB<S+E>P#ae4n*%q(d|%=WX>+uGakM
zCVT8k7mT*$L%6AF{9u^n>1LbkubEURPM^-2(KfEIc5I~*zihgdf9i7`U-2(Q9-Wxn
z6_zOk(c{k4Uz(t1$w|;@olQmEz81>9EzbAjwRLbAynrW4U>ulh>)vp#o7KBWpx2XD
z(gg3$N{qglYMOIh1ylBHB0;aCdgn;!6v#`mW*N@65(jGKCr~%MOBYB@#_}1zCtqCY
zo^xpB)9x1tg(R6~e~Y7ysHv%+D}>1E&4by|DfrtM>kCiE?0YH>-n|r{!gA{P$n0y{
zxus9oe{B+kr*?;+)(7ei%U5=Oj)F(7bgtFlGF=&Bx6enm5yG76i5?(M-RWmu<$8`S
zE&Sfoj`0n*zu?-b=ko4{9x0ZUv3!<3g;RKxx8wm=A+5Fbe}YNy3Z7}`N{sm>WGLVD
zTxi7;v|eqs9kZID?_78&wCMzba=mTUL&Gbdgu3|y*K<5;=tC}sSMZFO{KXh-oi4(N
z#yTjQKXkr^1dUC5jjUsG(xN&eDz|EW{h8}2W&0-xEuZE7I{K{mrPHllW?sQl`!jj_
zxue~qX%ml5e@>4ZJmofC|5wC*`wEP~W363b&0G9jX*$lYON_Y%vEMC&e!jCQnj6gW
z=l<GqmfSE0oC|$~`_hmtJk`<8opT8a?DH1SNFM0GZY-npT*PjB4r1Rns9&yxwskd4
z&D+SS`i_({te8<!aBrS46gqjI=Aa8Q-eH7e*8HcYe?Y0)>HcAnA~f9iuqR^6R6MtF
zh}TXI&N+n0BqVQRur}0k0zD1cdmwavTsYNoc&ri|{ghl%Q`-LLhE_k1@X`mJHOmw@
zlf=t{*YMt!KDyc)Zg>#d`gf2R^>fGR@bX6xe)I2;d4*)fchGt{HMzar4c?5~&eD{i
zX*F-zf5TM!d^K~z!RoHR8S#s~x!unbab|mI7825IIVQ=Q<u6x1^Gf#;SsRFNcTfW2
zSxUk$aE)^h4HPhFYHpbN6l5d{ufcJqZ^U#HG8Imw>!)7=W7v4gl@5oD_Hr*~Q%#bs
zP~GvVmHty{N^kSV7c3;LvkjA<aJI8}1Qyd5fA<06)Lm;rG8{98R?oK{yuDo(@f}8b
zS-YU6RcVP^>!4D-o9dDWnrfx(Ya!wLA2d#!Y2C@o%lJY}efW52n^#%gb?xcl;Tung
z1C;7JaF}=SqA({u?oNs)r#X6(yofJu>coZL*pz>wal#CkT;Dv>_qO9o2zkn}+h4M7
ze;wloAsPSNZjC+3i*AK}#udn;^;2ED2tse@Shrm}K0`+PAYOJ0^ih*Cd&wTfSKe$Y
zoPZC#KZmB?rH3}@c1GBymK8~HWBk0EV9@&Lg?^rn;wx`96IPva%W9~fF0njRrFu`(
z%_&j_HQmdg<#z}xsV{q$TDK(C&%PQae`S!Qhw`i)#W&t;YjDpG7q|H#xQl?o4z6<w
zs<Lnki8%N@Wq}e&57)YV45jpXpJF{ShA%!Pr*7-bmL+?iOhTOuP|SI(5!`S;hX};X
zAp$XTh(OF7A`ml&2*k`G0x@%lK+GIM5kgiY!1qY0R+5-XB?58+#WZCl0(_6If9F>y
zhM`m-z}L`HSy56Vs+E$GNF~j<!Mf>dk_KscvsB_+f&kxQnpnv{EiuUnnu`G6Vi+jr
zpO%=>Xrw%tYW;~2Vs3J&v?mQ_Bfxji64~-!PPBB&R8>_KYg+g#I@IwV|A1^!9*q`^
zZGO^XnI$D9Jk18y=_7PqOig{Rf7nmPX9<By1bCj*wXzwTm`Uq2CnCVpu)!q~n3;au
zQ8g(nEUcio<!%IcmPA5~O}9$MwFGwDaRsx;LWA|wgOF9;?It9Xv7Q-?7EYJaoQD7p
zA!imA7R<_Yw$<WvQBmO(eggz#9k$45wA+kU$Dke5*4EFUq4y);sKd^Vf0SZsGE3LS
zShSO>s#s|#Bv(+zp%ei}i*k-7Gp&*7ba>Y)TPg1v3q(C~bi^8MuR|wjveF6k>$E`B
zE~T7AoL5v7nTt+v*!#(AYhz{P^-fU~aZw;_XOLW2rh2kc-cd_Tr%P`Rz!s}%C^bzv
zLQ!Nf)k*s!zy@9T+ohD1AVR2>+_%H+9_S+e59TnMB?U{}D*ylh07*qoM6N<$f=T95
ATmS$7

delta 1382
zcmca1+s>`n8Q|y6%O%Cdz`(%k>ERLtq>F&Kn1c;Sx-^E}n5bw{&nn~T;uuoF`1Y=E
zk#wlQfsgOh6T2*q8874EHcL7v^^|3zzQaszf#*yDegeN)6s^k|MZIg7PpcnbXIQgA
zWuv>%3@xE&rgt}~M)xi8_&4ji@BdXfCnrAfdinl)+OxAq9CxI-2Acd>c2Zt)N1@f9
zi)TOA@UIg*BwDybtmRj&QdWH<`<(FE_qX3=DEz%DQD1b@<5ZdV*^73ZyT6F@omGiJ
zi?2rf`=Tp+XEN7KNN0R0_~XQGO<9*ecJXnyW<7T`Zl9t#Wy80g_htv~w)uHJJ$%(B
z|NN&X2B#-?-J9QU`G~LL$n7gDK340!|EuFa&q^s(>uH1i$Gc)XP6-?+dvNjO?Q`|-
zmOS_2sTA6HZt;YgbT!T`?IPFJj?S^zT6N?~!eoOtU&<|xOGs~eA#3}wL-SA?&sO!v
za+S&|`7u8~Fv&G~3kl`Oi0n20)sv%~TG?Bk_wC@)b=@KNtoIif7%3_D$#2uMy!q1b
z?*)S=rypfBw?DVC(2dehnfv>SL5f2KgP&+zy@7<D*cWFp_0;GGTO|8V)twMJ#AY#-
zspaeB=$|bW@^idumMz)udF1kDDeDJU9&J|1R&@FxD)Y3WDwpj;X6Rml55{({J{bSK
zB^Vf7Rwnge%3&V<-R>-YduQr>EqM8Pf?I`$vdt1fxl0`UnJw)mhn%GzD)xRr2-icz
z7x9U5ua7_UX#IW1x9j5_7Ju5?|M17<^$L15ETOAvT=eAZnyvowMO{729r5NLN9bys
zl)qPt8+LOybaOA@y%+i7|J~RB|FDI6r%P)ZzTd+f^`-v9G&cJh!Bx|)ojZ4Fw^q_O
z<$J!_Y@Ye+LzC2O&MuP(TvGXC;tMn5`l}sEcORcPlC(@FaLHbU2`BghUJ1JX(zX`O
zH#T(<v6}WmYgXFt&5cbRi$1CDn(67YZ{g$c0_iP1M;K$fpKafA_KH~G3+vy7hj07z
z3bvlR9AOR=k_vobD_?om(9~UIm%mQ@WwYRFmxcei8nyF`bzMZv^uF$RVv?=8XhZSY
zbM<o!bzMca>Ft|UI6G5!(S~x-yV2WbiYar=p6={7BW<mlNZI=Ay#kkuTo$HZ{9~k|
zHt`Ra>t(^#w-cJS&-~B+&!4RaDKwD-d4)~Nn)MB38~1SmgX_u1Q_~$1Ikzk-VE=c{
zu6@<gkEdU1I%)7b)XTH1O8xXd(D~}62$SOzj(k}%^ZgqM)Hp&m71=V*o2<)YuRG6j
znCrk${h&m-O76#HJ&UUx1^O->c1lwpx8>?|DJidc`}w-0Mei={o4+ehe2ytAs|nF+
z<+xpR+rCd{<(+z_<(D%(WNK<}y#4s4i?^UFAYC>3pUXSm@G>P=`KhN84xD}X_cQ;8
z6@O;_U%~0uxcQ=n+qEd~uKNwa597Py=lriyd6G46d*=(y9ZL!qujT(-^TdPsxb4N|
zH>ULZtz=I2Pfo1A5yT#owBm5?wPUtTlj9C)+wmUS@VH%NrA6ln?s|*4h5e7VOs_f<
z;?u9OEKX5De@gy=<-4{W3|)Gb_nmLI#<IQ>pZU7(sVUj9m3y!7W{H-6a{B(cPj6;A
zbIr_BX5swBaL4yiV1!-GZ4I0JbrYE7zNmfRV99aUnt$q}&6$@$itH*GoENwv9xpg@
zeC~_qCeNK}xCFloWJ)LfdH7|D&7-9;nonHoMO-I;pC`rPC?;&gv4iKG&yqNf4e`fr
jbl33xc=YN_=pS|^$NWG0H{Nam7M%>9u6{1-oD!M<<#vqy

diff --git a/docs-website/static/img/solutions/integrations-observe/logo-integration-7.png b/docs-website/static/img/solutions/integrations-observe/logo-integration-7.png
new file mode 100644
index 0000000000000000000000000000000000000000..acc17cb75d58560e703a0e19327d6d0e8fa4a8b5
GIT binary patch
literal 2329
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

literal 0
HcmV?d00001

diff --git a/docs-website/static/img/solutions/integrations-observe/logo-integration-8.png b/docs-website/static/img/solutions/integrations-observe/logo-integration-8.png
new file mode 100644
index 0000000000000000000000000000000000000000..d9bb08766f527311a0dc18ebca1504cc8dd8cfae
GIT binary patch
literal 1415
zcmZvcdpOez9L9gLW;VBJ^9Yg6{W90I+;Z7Mn8;2-7P%zKt!FOnoRFfqAG%C*(Oh!M
zC1MXpiJb`BNh3;bGntOdhDwZ`o#*^_I)A+1_xXPQeBbAJuOB10$wSqk0078)xa0gJ
zo+wcg1T49@jGx9NCL8a5G6?`+d;XCWP*$!gfl^6+ZZ1GQTVp};fTEneodKY!5GD%U
z4FJ0}JaEqbDN;)l-ihi&r7q#Jekc|D%BorpW)t>OZ4Ojy=0t-j&F@koC~bkX?Z_EO
zPm1(_ewPgJxKXFc&GNR9@}~n6Pj!O|=<YjZqu%1W*w@9pqYEqFB0sU1&WuRBuk}Xt
zYpuPE1Y6M%YmK5<5AQ}MFjTTOe@30lkSRZLXR2)iNZ6_iHADV78=<ihQ^{aYRmv{g
zUNq10HXyAe4l4{s*B3=eEx<SWIt=&WM2@784`uUstL#$4(#EfOD>hvd*9abSJtOvU
zf3EV(2TG`u_X-bj6;hbv!?nUon3Zi4pS!lG2&1|5!@>y_M!!-Qd3xyeID45s?<JS2
z+{AuZM2XUqZOKNA>itoUeU`=?K3!tIxSovdRaJk=-{&CAG3<_%d!|3DnTpnl3;r(H
zrJ3QWtQ@O>=sdWY7mJQa%}>7Y^<`CkuK%Rni+FQO6uLmG6?5qQg2nb5bKU^=?3L_!
zTdZlIS$M_Puz9#s3P3=Hn5$w`)?HQfBZ8(|_7?R2(x==F#@^VK^`#`}dsd28`B6$W
z{e=gU)2wDUJ<M&^iP3fuAT{Pv($0eg(Zo(AftBNDfz|d0xbJZ?S#7$sM^3TB4Mgaq
zVZOvKtQ8$eaYx(J;hJwDiqTow*4?gZGurur|KdsoB&>nd&25-+UTPpYJzVW9oY~+s
z?8i_*#5xKNqv?3Xc3UBEqz4wTxC0^nW*@#il9b*7OV5Sfm!CYz7f<{p7J-SLQR;>k
zE5Azzu3r}11Rtir>u$bdv)^_Yg?&X&ddGl0;u?rydiJbpRbP7QMls*UY9t3WG26!s
ztJd(PckVChQ#ke+j^8x4L&jMhz#(jJ@{P(Ox0*9Db1GML+i4zN&mYX5h*xjPV@jRM
z{nXaN8dmY;+ifNEjC<w7ud+D-2PH_&m+zpJ%Cb1%hG_ROA#rSuU&1{QLo<voSefDw
zHkdCAo^_0FWn&VHU2b8DN3>#|mnGbZHmz(-Mot8^(p1pUJGWd3w<Dh%L693_I+Zwy
zxCc=~B1;{;Vi6S2fnQxJ%50;FWp;ePc|Sz?Z^E_q;g1{A$xY9plCXHf{##C=vMrVI
zGCOR??7Ax9z=ENRfufTZs4ikv?CU!6Ho&^Kh`COutt_hkUq3(ACi{MO&8bn>GN%eB
z;L`L(beiS{2ZJ4f#GB!A98ouBubnrcqR@|*)<*YY^V^NzZ>9FF1(V4Xf1|6A@x<}N
z1tyO^?yBKLyK7K>9$ONwQ|05S$D(wDc5ut`C&(zg){XwtU96eyHAO+Kh$gO;C1f-Y
z860^R=t-SQKR!dElFG$tI=pjt+phBs8T5pQPZZZEJa_3{hoPFW(tN@r=`%iOLNAZ`
z$pnYh_MCtB$|18Pq}$k0zPoWYTjvq>dLIm1kx<BOxs^8P?^S3}9iqM8tTe8xroHtg
zv5F<X?44^+UC_6tK%LY>If9ctYdt|hTD*ZN_Ua<d6-qmY2FY#$AHBK00gjY$1N*r8
zB5BQaJplw1>t=MXUuZwL;HNF4b5`~ZG+_2Vv$ujjZ$0lqfx^EjMXQI2X4Xr&Rl$Zl
z{AC2b<l9{}h_lKbO9(@5*^3?mX(YWG%cUr6a6b<cMKUPoIMIuy@hr)10v>n*uHNNz
F=HDsFkPH9-

literal 0
HcmV?d00001


From 9329916239408655b940ea5d9e45a36a31432bf6 Mon Sep 17 00:00:00 2001
From: chriscc2 <chriscc2@uci.edu>
Date: Thu, 31 Oct 2024 15:50:41 -0700
Subject: [PATCH 09/21] feat(ingest): unpin looker-sdk dependency (#11755)

Co-authored-by: Chris Chan <chriscchan@google.com>
---
 metadata-ingestion/setup.py | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/metadata-ingestion/setup.py b/metadata-ingestion/setup.py
index 606c2b89303b7..6579761cc5c14 100644
--- a/metadata-ingestion/setup.py
+++ b/metadata-ingestion/setup.py
@@ -173,7 +173,7 @@
 
 looker_common = {
     # Looker Python SDK
-    "looker-sdk==23.0.0",
+    "looker-sdk>=23.0.0",
     # This version of lkml contains a fix for parsing lists in
     # LookML files with spaces between an item and the following comma.
     # See https://github.com/joshtemple/lkml/issues/73.

From 8b72076e732267d8ff0bcc9a559a1554d8d87467 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Felix=20L=C3=BCdin?=
 <13187726+Masterchen09@users.noreply.github.com>
Date: Thu, 31 Oct 2024 23:55:17 +0100
Subject: [PATCH 10/21] feat(forms/cli): add additional filters to the forms
 CLI (subtypes, platform instances, owners, tags and glossary terms) (#10979)

---
 .../src/datahub/api/entities/forms/forms.py   | 113 +++++++++++++-----
 .../structuredproperties.py                   |   8 +-
 .../src/datahub/emitter/mce_builder.py        |  12 +-
 3 files changed, 99 insertions(+), 34 deletions(-)

diff --git a/metadata-ingestion/src/datahub/api/entities/forms/forms.py b/metadata-ingestion/src/datahub/api/entities/forms/forms.py
index 9188ea33d6c68..fa6453851e0e7 100644
--- a/metadata-ingestion/src/datahub/api/entities/forms/forms.py
+++ b/metadata-ingestion/src/datahub/api/entities/forms/forms.py
@@ -16,8 +16,12 @@
 )
 from datahub.configuration.common import ConfigModel
 from datahub.emitter.mce_builder import (
+    make_container_urn,
     make_data_platform_urn,
+    make_domain_urn,
     make_group_urn,
+    make_tag_urn,
+    make_term_urn,
     make_user_urn,
 )
 from datahub.emitter.mcp import MetadataChangeProposalWrapper
@@ -36,6 +40,16 @@
 logging.basicConfig(level=logging.INFO)
 logger = logging.getLogger(__name__)
 
+FILTER_CRITERION_TYPES = "_entityType"
+FILTER_CRITERION_SUB_TYPES = "typeNames.keyword"
+FILTER_CRITERION_PLATFORMS = "platform.keyword"
+FILTER_CRITERION_PLATFORM_INSTANCES = "dataPlatformInstance.keyword"
+FILTER_CRITERION_DOMAINS = "domains.keyword"
+FILTER_CRITERION_CONTAINERS = "container.keyword"
+FILTER_CRITERION_OWNERS = "owners.keyword"
+FILTER_CRITERION_TAGS = "tags.keyword"
+FILTER_CRITERION_GLOSSARY_TERMS = "glossaryTerms.keyword"
+
 
 class PromptType(Enum):
     STRUCTURED_PROPERTY = "STRUCTURED_PROPERTY"
@@ -73,9 +87,14 @@ def has_value(cls, value):
 
 class Filters(ConfigModel):
     types: Optional[List[str]] = None
+    sub_types: Optional[List[str]] = None
     platforms: Optional[List[str]] = None
+    platform_instances: Optional[List[str]] = None
     domains: Optional[List[str]] = None
     containers: Optional[List[str]] = None
+    owners: Optional[List[str]] = None
+    tags: Optional[List[str]] = None
+    terms: Optional[List[str]] = None
 
 
 class Entities(ConfigModel):
@@ -105,7 +124,8 @@ class Forms(ConfigModel):
     @validator("urn", pre=True, always=True)
     def urn_must_be_present(cls, v, values):
         if not v:
-            assert values.get("id") is not None, "Form id must be present if urn is not"
+            if values.get("id") is None:
+                raise ValueError("Form id must be present if urn is not")
             return f"urn:li:form:{values['id']}"
         return v
 
@@ -249,29 +269,70 @@ def create_form_filters(self, emitter: DataHubGraph) -> Union[None, Exception]:
         # Loop through each entity and assign a filter for it
         if self.entities and self.entities.filters:
             filters = self.entities.filters
+
             if filters.types:
                 filters_raw.append(
-                    Forms.format_form_filter("_entityType", filters.types)
+                    Forms.format_form_filter(FILTER_CRITERION_TYPES, filters.types)
+                )
+
+            if filters.sub_types:
+                filters_raw.append(
+                    Forms.format_form_filter(
+                        FILTER_CRITERION_SUB_TYPES, filters.sub_types
+                    )
                 )
+
             if filters.platforms:
                 urns = [
                     make_data_platform_urn(platform) for platform in filters.platforms
                 ]
-                filters_raw.append(Forms.format_form_filter("platform", urns))
-            if filters.domains:
+                filters_raw.append(
+                    Forms.format_form_filter(FILTER_CRITERION_PLATFORMS, urns)
+                )
+
+            if filters.platform_instances:
                 urns = []
-                for domain in filters.domains:
-                    domain_urn = Forms.validate_domain_urn(domain)
-                    if domain_urn:
-                        urns.append(domain_urn)
-                filters_raw.append(Forms.format_form_filter("domains", urns))
+                for platform_instance in filters.platform_instances:
+                    platform_instance_urn = Forms.validate_platform_instance_urn(
+                        platform_instance
+                    )
+                    if platform_instance_urn:
+                        urns.append(platform_instance_urn)
+                filters_raw.append(
+                    Forms.format_form_filter(FILTER_CRITERION_PLATFORM_INSTANCES, urns)
+                )
+
+            if filters.domains:
+                urns = [make_domain_urn(domain) for domain in filters.domains]
+                filters_raw.append(
+                    Forms.format_form_filter(FILTER_CRITERION_DOMAINS, urns)
+                )
+
             if filters.containers:
-                urns = []
-                for container in filters.containers:
-                    container_urn = Forms.validate_container_urn(container)
-                    if container_urn:
-                        urns.append(container_urn)
-                filters_raw.append(Forms.format_form_filter("container", urns))
+                urns = [
+                    make_container_urn(container) for container in filters.containers
+                ]
+                filters_raw.append(
+                    Forms.format_form_filter(FILTER_CRITERION_CONTAINERS, urns)
+                )
+
+            if filters.owners:
+                urns = [make_user_urn(owner) for owner in filters.owners]
+                filters_raw.append(
+                    Forms.format_form_filter(FILTER_CRITERION_OWNERS, urns)
+                )
+
+            if filters.tags:
+                urns = [make_tag_urn(tag) for tag in filters.tags]
+                filters_raw.append(
+                    Forms.format_form_filter(FILTER_CRITERION_TAGS, urns)
+                )
+
+            if filters.terms:
+                urns = [make_term_urn(term) for term in filters.terms]
+                filters_raw.append(
+                    Forms.format_form_filter(FILTER_CRITERION_GLOSSARY_TERMS, urns)
+                )
 
         filters_str = ", ".join(item for item in filters_raw)
         result = emitter.execute_graphql(
@@ -279,6 +340,7 @@ def create_form_filters(self, emitter: DataHubGraph) -> Union[None, Exception]:
                 form_urn=self.urn, filters=filters_str
             )
         )
+
         if not result:
             return Exception(
                 f"Could not bulk upload urns or filters for form {self.urn}."
@@ -314,25 +376,20 @@ def format_form_filter(field: str, urns: List[str]) -> str:
         return FIELD_FILTER_TEMPLATE.format(field=field, values=formatted_urns)
 
     @staticmethod
-    def validate_domain_urn(domain: str) -> Union[str, None]:
-        if domain.startswith("urn:li:domain:"):
-            return domain
+    def validate_platform_instance_urn(instance: str) -> Union[str, None]:
+        if instance.startswith("urn:li:dataPlatformInstance:"):
+            return instance
 
-        logger.warning(f"{domain} is not an urn. Unable to create domain filter.")
-        return None
-
-    @staticmethod
-    def validate_container_urn(container: str) -> Union[str, None]:
-        if container.startswith("urn:li:container:"):
-            return container
-
-        logger.warning(f"{container} is not an urn. Unable to create container filter.")
+        logger.warning(
+            f"{instance} is not an urn. Unable to create platform instance filter."
+        )
         return None
 
     @staticmethod
     def from_datahub(graph: DataHubGraph, urn: str) -> "Forms":
         form: Optional[FormInfoClass] = graph.get_aspect(urn, FormInfoClass)
-        assert form is not None
+        if form is None:
+            raise Exception("FormInfo aspect is None. Unable to create form.")
         prompts = []
         for prompt_raw in form.prompts:
             prompts.append(
diff --git a/metadata-ingestion/src/datahub/api/entities/structuredproperties/structuredproperties.py b/metadata-ingestion/src/datahub/api/entities/structuredproperties/structuredproperties.py
index 5b188edf9563b..060d6b00b1a12 100644
--- a/metadata-ingestion/src/datahub/api/entities/structuredproperties/structuredproperties.py
+++ b/metadata-ingestion/src/datahub/api/entities/structuredproperties/structuredproperties.py
@@ -89,7 +89,8 @@ def fqn(self) -> str:
     @validator("urn", pre=True, always=True)
     def urn_must_be_present(cls, v, values):
         if not v:
-            assert "id" in values, "id must be present if urn is not"
+            if "id" not in values:
+                raise ValueError("id must be present if urn is not")
             return f"urn:li:structuredProperty:{values['id']}"
         return v
 
@@ -154,7 +155,10 @@ def from_datahub(cls, graph: DataHubGraph, urn: str) -> "StructuredProperties":
         structured_property: Optional[
             StructuredPropertyDefinitionClass
         ] = graph.get_aspect(urn, StructuredPropertyDefinitionClass)
-        assert structured_property is not None
+        if structured_property is None:
+            raise Exception(
+                "StructuredPropertyDefinition aspect is None. Unable to create structured property."
+            )
         return StructuredProperties(
             urn=urn,
             qualified_name=structured_property.qualifiedName,
diff --git a/metadata-ingestion/src/datahub/emitter/mce_builder.py b/metadata-ingestion/src/datahub/emitter/mce_builder.py
index d3a930d988171..63b03db7f5b60 100644
--- a/metadata-ingestion/src/datahub/emitter/mce_builder.py
+++ b/metadata-ingestion/src/datahub/emitter/mce_builder.py
@@ -163,11 +163,15 @@ def dataset_key_to_urn(key: DatasetKeyClass) -> str:
 
 
 def make_container_urn(guid: Union[str, "DatahubKey"]) -> str:
-    from datahub.emitter.mcp_builder import DatahubKey
+    if isinstance(guid, str) and guid.startswith("urn:li:container"):
+        return guid
+    else:
+        from datahub.emitter.mcp_builder import DatahubKey
+
+        if isinstance(guid, DatahubKey):
+            guid = guid.guid()
 
-    if isinstance(guid, DatahubKey):
-        guid = guid.guid()
-    return f"urn:li:container:{guid}"
+        return f"urn:li:container:{guid}"
 
 
 def container_urn_to_key(guid: str) -> Optional[ContainerKeyClass]:

From 4634bbcae0ee4f6238cc12f846f10ab2e251462a Mon Sep 17 00:00:00 2001
From: Steffen Grohsschmiedt <gitbhub@steffeng.eu>
Date: Fri, 1 Nov 2024 00:01:25 +0100
Subject: [PATCH 11/21] docs(spark): fix incorrect config option (#11119)

---
 metadata-integration/java/acryl-spark-lineage/README.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/metadata-integration/java/acryl-spark-lineage/README.md b/metadata-integration/java/acryl-spark-lineage/README.md
index 9caa5a6dec65d..bd0a58b635b48 100644
--- a/metadata-integration/java/acryl-spark-lineage/README.md
+++ b/metadata-integration/java/acryl-spark-lineage/README.md
@@ -184,7 +184,7 @@ information like tokens.
 | spark.datahub.platform.s3.path_spec_list               |          |                       | List of pathspec per platform                                                                                                                                                             |
 | spark.datahub.metadata.dataset.include_schema_metadata | false    |                       | Emit dataset schema metadata based on the spark execution. It is recommended to get schema information from platform specific DataHub sources  as this is less reliable                   |
 | spark.datahub.flow_name                                |          |                       | If it is set it will be used as the DataFlow name otherwise it uses spark app name as flow_name                                                                                           |
-| spark.datahub.partition_regexp_pattern                 |          |                       | Strip partition part from the path if path end matches with the specified regexp. Example `year=.*/month=.*/day=.*`                                                                       |
+| spark.datahub.file_partition_regexp                    |          |                       | Strip partition part from the path if path end matches with the specified regexp. Example `year=.*/month=.*/day=.*`                                                                       |
 | spark.datahub.tags                                     |          |                       | Comma separated list of tags to attach to the DataFlow                                                                                                                                    |
 | spark.datahub.domains                                  |          |                       | Comma separated list of domain urns to attach to the DataFlow                                                                                                                             |
 | spark.datahub.stage_metadata_coalescing                |          |                       | Normally it coalesces and sends metadata at the onApplicationEnd event which is never called on Databricks or on Glue. You should enable this on Databricks if you want coalesced run.    |

From e609ff810d5cfd0b17e66c8c25e65e18917a275f Mon Sep 17 00:00:00 2001
From: Harshal Sheth <hsheth2@gmail.com>
Date: Thu, 31 Oct 2024 16:27:45 -0700
Subject: [PATCH 12/21] feat(ingest/powerbi): improve reporting around m-query
 parser (#11763)

---
 metadata-ingestion/setup.py                   |  3 +++
 .../ingestion/source/powerbi/config.py        | 10 ++++++++
 .../source/powerbi/m_query/parser.py          | 20 ++++++++++------
 .../source/powerbi/m_query/resolver.py        | 15 +++++++-----
 .../datahub/sql_parsing/schema_resolver.py    | 23 +++++++++++++++++--
 .../datahub/utilities/partition_executor.py   |  3 +++
 .../src/datahub/utilities/perf_timer.py       |  1 -
 .../unit/sql_parsing/test_schemaresolver.py   |  5 ++++
 .../tests/unit/utilities/test_perf_timer.py   | 18 ++++++++++++---
 9 files changed, 79 insertions(+), 19 deletions(-)

diff --git a/metadata-ingestion/setup.py b/metadata-ingestion/setup.py
index 6579761cc5c14..b10143565efb4 100644
--- a/metadata-ingestion/setup.py
+++ b/metadata-ingestion/setup.py
@@ -278,6 +278,9 @@
 
 threading_timeout_common = {
     "stopit==1.1.2",
+    # stopit uses pkg_resources internally, which means there's an implied
+    # dependency on setuptools.
+    "setuptools",
 }
 
 abs_base = {
diff --git a/metadata-ingestion/src/datahub/ingestion/source/powerbi/config.py b/metadata-ingestion/src/datahub/ingestion/source/powerbi/config.py
index 0aec9a589cf27..09ade4c905bea 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/powerbi/config.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/powerbi/config.py
@@ -20,6 +20,7 @@
     StatefulIngestionConfigBase,
 )
 from datahub.utilities.lossy_collections import LossyList
+from datahub.utilities.perf_timer import PerfTimer
 
 logger = logging.getLogger(__name__)
 
@@ -190,6 +191,15 @@ class PowerBiDashboardSourceReport(StaleEntityRemovalSourceReport):
     filtered_dashboards: List[str] = dataclass_field(default_factory=list)
     filtered_charts: List[str] = dataclass_field(default_factory=list)
 
+    m_query_parse_timer: PerfTimer = dataclass_field(default_factory=PerfTimer)
+    m_query_parse_attempts: int = 0
+    m_query_parse_successes: int = 0
+    m_query_parse_timeouts: int = 0
+    m_query_parse_validation_errors: int = 0
+    m_query_parse_unexpected_character_errors: int = 0
+    m_query_parse_unknown_errors: int = 0
+    m_query_resolver_errors: int = 0
+
     def report_dashboards_scanned(self, count: int = 1) -> None:
         self.dashboards_scanned += count
 
diff --git a/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/parser.py b/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/parser.py
index 086ce2c263b0c..a61ad8d289b9d 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/parser.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/parser.py
@@ -74,7 +74,9 @@ def get_upstream_tables(
     )
 
     try:
-        parse_tree: Tree = _parse_expression(table.expression)
+        with reporter.m_query_parse_timer:
+            reporter.m_query_parse_attempts += 1
+            parse_tree: Tree = _parse_expression(table.expression)
 
         valid, message = validator.validate_parse_tree(
             parse_tree, native_query_enabled=config.native_query_parsing
@@ -87,10 +89,12 @@ def get_upstream_tables(
                 message="DataAccess function is not present in M-Query expression",
                 context=f"table-full-name={table.full_name}, expression={table.expression}, message={message}",
             )
+            reporter.m_query_parse_validation_errors += 1
             return []
     except KeyboardInterrupt:
         raise
     except TimeoutException:
+        reporter.m_query_parse_timeouts += 1
         reporter.warning(
             title="M-Query Parsing Timeout",
             message=f"M-Query parsing timed out after {_M_QUERY_PARSE_TIMEOUT} seconds. Lineage for this table will not be extracted.",
@@ -102,8 +106,10 @@ def get_upstream_tables(
     ) as e:  # TODO: Debug why BaseException is needed here and below.
         if isinstance(e, lark.exceptions.UnexpectedCharacters):
             error_type = "Unexpected Character Error"
+            reporter.m_query_parse_unexpected_character_errors += 1
         else:
             error_type = "Unknown Parsing Error"
+            reporter.m_query_parse_unknown_errors += 1
 
         reporter.warning(
             title="Unable to extract lineage from M-Query expression",
@@ -112,10 +118,10 @@ def get_upstream_tables(
             exc=e,
         )
         return []
+    reporter.m_query_parse_successes += 1
 
-    lineage: List[resolver.Lineage] = []
     try:
-        lineage = resolver.MQueryResolver(
+        lineage: List[resolver.Lineage] = resolver.MQueryResolver(
             table=table,
             parse_tree=parse_tree,
             reporter=reporter,
@@ -126,14 +132,14 @@ def get_upstream_tables(
             platform_instance_resolver=platform_instance_resolver,
         )
 
+        return lineage
+
     except BaseException as e:
+        reporter.m_query_resolver_errors += 1
         reporter.warning(
             title="Unknown M-Query Pattern",
             message="Encountered a unknown M-Query Expression",
             context=f"table-full-name={table.full_name}, expression={table.expression}, message={e}",
             exc=e,
         )
-
-        logger.debug(f"Stack trace for {table.full_name}:", exc_info=e)
-
-    return lineage
+        return []
diff --git a/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/resolver.py b/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/resolver.py
index a5fb6fd2673ac..cc51fcee14104 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/resolver.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/powerbi/m_query/resolver.py
@@ -356,8 +356,9 @@ def _process_invoke_expression(
             )
             if arg_list is None:
                 self.reporter.report_warning(
-                    f"{self.table.full_name}-arg-list",
-                    f"Argument list not found for data-access-function {data_access_func}",
+                    title="M-Query Resolver Error",
+                    message="Unable to extract lineage from parsed M-Query expression (missing argument list)",
+                    context=f"{self.table.full_name}: argument list not found for data-access-function {data_access_func}",
                 )
                 return None
 
@@ -377,8 +378,9 @@ def _process_invoke_expression(
                 f"Function invocation without argument in expression = {invoke_expression.pretty()}"
             )
             self.reporter.report_warning(
-                f"{self.table.full_name}-variable-statement",
-                "Function invocation without argument",
+                title="M-Query Resolver Error",
+                message="Unable to extract lineage from parsed M-Query expression (function invocation without argument)",
+                context=f"{self.table.full_name}: function invocation without argument",
             )
             return None
 
@@ -403,8 +405,9 @@ def _process_invoke_expression(
                     f"Either list_expression or type_expression is not found = {invoke_expression.pretty()}"
                 )
                 self.reporter.report_warning(
-                    f"{self.table.full_name}-variable-statement",
-                    "Function argument expression is not supported",
+                    title="M-Query Resolver Error",
+                    message="Unable to extract lineage from parsed M-Query expression (function argument expression is not supported)",
+                    context=f"{self.table.full_name}: function argument expression is not supported",
                 )
                 return None
 
diff --git a/metadata-ingestion/src/datahub/sql_parsing/schema_resolver.py b/metadata-ingestion/src/datahub/sql_parsing/schema_resolver.py
index c358bee6daae8..e7b0527d30d97 100644
--- a/metadata-ingestion/src/datahub/sql_parsing/schema_resolver.py
+++ b/metadata-ingestion/src/datahub/sql_parsing/schema_resolver.py
@@ -90,7 +90,9 @@ def schema_count(self) -> int:
             )[0][0]
         )
 
-    def get_urn_for_table(self, table: _TableName, lower: bool = False) -> str:
+    def get_urn_for_table(
+        self, table: _TableName, lower: bool = False, mixed: bool = False
+    ) -> str:
         # TODO: Validate that this is the correct 2/3 layer hierarchy for the platform.
 
         table_name = ".".join(
@@ -101,7 +103,10 @@ def get_urn_for_table(self, table: _TableName, lower: bool = False) -> str:
 
         if lower:
             table_name = table_name.lower()
-            platform_instance = platform_instance.lower() if platform_instance else None
+            if not mixed:
+                platform_instance = (
+                    platform_instance.lower() if platform_instance else None
+                )
 
         if self.platform == "bigquery":
             # Normalize shard numbers and other BigQuery weirdness.
@@ -131,6 +136,20 @@ def resolve_table(self, table: _TableName) -> Tuple[str, Optional[SchemaInfo]]:
             if schema_info:
                 return urn_lower, schema_info
 
+        # Our treatment of platform instances when lowercasing urns
+        # is inconsistent. In some places (e.g. Snowflake), we lowercase
+        # the table names but not the platform instance. In other places
+        # (e.g. Databricks), we lowercase everything because it happens
+        # via the automatic lowercasing helper.
+        # See https://github.com/datahub-project/datahub/pull/8928.
+        # While we have this sort of inconsistency, we should also
+        # check the mixed case urn, as a last resort.
+        urn_mixed = self.get_urn_for_table(table, lower=True, mixed=True)
+        if urn_mixed not in {urn, urn_lower}:
+            schema_info = self._resolve_schema_info(urn_mixed)
+            if schema_info:
+                return urn_mixed, schema_info
+
         if self._prefers_urn_lower():
             return urn_lower, None
         else:
diff --git a/metadata-ingestion/src/datahub/utilities/partition_executor.py b/metadata-ingestion/src/datahub/utilities/partition_executor.py
index 92413eeb674f5..237ffc6dc611b 100644
--- a/metadata-ingestion/src/datahub/utilities/partition_executor.py
+++ b/metadata-ingestion/src/datahub/utilities/partition_executor.py
@@ -294,6 +294,9 @@ def _clearinghouse_worker(self) -> None:  # noqa: C901
         def _handle_batch_completion(
             batch: List[_BatchPartitionWorkItem], future: Future
         ) -> None:
+            nonlocal workers_available
+            workers_available += 1
+
             with clearinghouse_state_lock:
                 for item in batch:
                     keys_no_longer_in_flight.add(item.key)
diff --git a/metadata-ingestion/src/datahub/utilities/perf_timer.py b/metadata-ingestion/src/datahub/utilities/perf_timer.py
index 18384420bfefb..9488683d6d8ca 100644
--- a/metadata-ingestion/src/datahub/utilities/perf_timer.py
+++ b/metadata-ingestion/src/datahub/utilities/perf_timer.py
@@ -9,7 +9,6 @@
 class PerfTimer(AbstractContextManager):
     """
     A context manager that gives easy access to elapsed time for performance measurement.
-
     """
 
     def __init__(self) -> None:
diff --git a/metadata-ingestion/tests/unit/sql_parsing/test_schemaresolver.py b/metadata-ingestion/tests/unit/sql_parsing/test_schemaresolver.py
index 5a33034f274dc..e5fa980bec452 100644
--- a/metadata-ingestion/tests/unit/sql_parsing/test_schemaresolver.py
+++ b/metadata-ingestion/tests/unit/sql_parsing/test_schemaresolver.py
@@ -41,6 +41,11 @@ def test_get_urn_for_table_lowercase():
         == "urn:li:dataset:(urn:li:dataPlatform:mssql,uppercased-instance.database.dataset.table,PROD)"
     )
 
+    assert (
+        schema_resolver.get_urn_for_table(table=table, lower=True, mixed=True)
+        == "urn:li:dataset:(urn:li:dataPlatform:mssql,Uppercased-Instance.database.dataset.table,PROD)"
+    )
+
 
 def test_get_urn_for_table_not_lower_should_keep_capital_letters():
     schema_resolver = SchemaResolver(
diff --git a/metadata-ingestion/tests/unit/utilities/test_perf_timer.py b/metadata-ingestion/tests/unit/utilities/test_perf_timer.py
index 1de76a32fb708..166e40ef54308 100644
--- a/metadata-ingestion/tests/unit/utilities/test_perf_timer.py
+++ b/metadata-ingestion/tests/unit/utilities/test_perf_timer.py
@@ -8,7 +8,7 @@
 approx = partial(pytest.approx, rel=2e-2)
 
 
-def test_perf_timer_simple():
+def test_perf_timer_simple() -> None:
     with PerfTimer() as timer:
         time.sleep(0.4)
         assert approx(timer.elapsed_seconds()) == 0.4
@@ -16,7 +16,7 @@ def test_perf_timer_simple():
     assert approx(timer.elapsed_seconds()) == 0.4
 
 
-def test_perf_timer_paused_timer():
+def test_perf_timer_paused_timer() -> None:
     with PerfTimer() as current_timer:
         time.sleep(0.5)
         assert approx(current_timer.elapsed_seconds()) == 0.5
@@ -29,7 +29,7 @@ def test_perf_timer_paused_timer():
     assert approx(current_timer.elapsed_seconds()) == 0.7
 
 
-def test_generator_with_paused_timer():
+def test_generator_with_paused_timer() -> None:
     n = 4
 
     def generator_function():
@@ -46,3 +46,15 @@ def generator_function():
         seq = generator_function()
         list([i for i in seq])
         assert approx(outer_timer.elapsed_seconds()) == 1 + 0.2 * n + 0.2 * n
+
+
+def test_perf_timer_reuse() -> None:
+    timer = PerfTimer()
+
+    with timer:
+        time.sleep(0.2)
+
+    with timer:
+        time.sleep(0.3)
+
+    assert approx(timer.elapsed_seconds()) == 0.5

From b58ffb665fda58f346d5dd43fa3a538b51e630ca Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Juan=20Manuel=20M=C3=A9ndez=20Rey?= <vejeta@gmail.com>
Date: Fri, 1 Nov 2024 05:00:52 +0100
Subject: [PATCH 13/21] docs(graphql): fix typo in entity.graphql (#11764)

---
 datahub-graphql-core/src/main/resources/entity.graphql | 4 ++--
 1 file changed, 2 insertions(+), 2 deletions(-)

diff --git a/datahub-graphql-core/src/main/resources/entity.graphql b/datahub-graphql-core/src/main/resources/entity.graphql
index b3728aa676490..732a782139b61 100644
--- a/datahub-graphql-core/src/main/resources/entity.graphql
+++ b/datahub-graphql-core/src/main/resources/entity.graphql
@@ -645,7 +645,7 @@ type Mutation {
     updateERModelRelationship(
         "The urn of the ERModelRelationship to update"
         urn: String!,
-        "Input required to updat an existing DataHub View"
+        "Input required to update an existing DataHub View"
         input: ERModelRelationshipUpdateInput!): Boolean
 
     """
@@ -795,7 +795,7 @@ type Mutation {
     updateView(
       "The urn of the View to update"
       urn: String!,
-      "Input required to updat an existing DataHub View"
+      "Input required to update an existing DataHub View"
       input: UpdateViewInput!): DataHubView
 
     """

From 00a2751764b45cdd0345763199b036ae4c20c5ed Mon Sep 17 00:00:00 2001
From: Tanguy Antoine <tanguyantoine@users.noreply.github.com>
Date: Fri, 1 Nov 2024 05:03:00 +0100
Subject: [PATCH 14/21] doc(bigquery): Update setup.md (#11769)

---
 docs/quick-ingestion-guides/bigquery/setup.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/quick-ingestion-guides/bigquery/setup.md b/docs/quick-ingestion-guides/bigquery/setup.md
index 96850f2deb68e..7144ad6403ce9 100644
--- a/docs/quick-ingestion-guides/bigquery/setup.md
+++ b/docs/quick-ingestion-guides/bigquery/setup.md
@@ -30,7 +30,7 @@ Please refer to the BigQuery [Permissions](https://cloud.google.com/iam/docs/per
    * [BigQuery Job User](https://cloud.google.com/bigquery/docs/access-control#bigquery.jobUser)
    * [BigQuery Metadata Viewer](https://cloud.google.com/bigquery/docs/access-control#bigquery.metadataViewer)
    * [BigQuery Resource Viewer](https://cloud.google.com/bigquery/docs/access-control#bigquery.resourceViewer) -> This role is for Table-Level Lineage and Usage extraction
-   * [Logs View Accessor](https://cloud.google.com/bigquery/docs/access-control#bigquery.dataViewer) -> This role is for Table-Level Lineage and Usage extraction
+   * [Logs View Accessor](https://cloud.google.com/logging/docs/access-control#logging.viewAccessor) -> This role is for Table-Level Lineage and Usage extraction
    * [BigQuery Data Viewer](https://cloud.google.com/bigquery/docs/access-control#bigquery.dataViewer) -> This role is for Profiling
    * [BigQuery Read Session User](https://cloud.google.com/bigquery/docs/access-control#bigquery.readSessionUser) -> This role is for Profiling
 

From 95f361ab4429ce07b6ea8cbe1ec38f52fadd4ec4 Mon Sep 17 00:00:00 2001
From: Hyejin Yoon <0327jane@gmail.com>
Date: Mon, 4 Nov 2024 17:18:58 +0900
Subject: [PATCH 15/21] fix: install servicebell & add condition for markprompt
 (#11532)

---
 docs-website/package.json              | 1 +
 docs-website/src/pages/cloud/index.js  | 9 ++++++++-
 docs-website/src/theme/Footer/index.js | 6 +++++-
 docs-website/yarn.lock                 | 5 +++++
 4 files changed, 19 insertions(+), 2 deletions(-)

diff --git a/docs-website/package.json b/docs-website/package.json
index e1130148864e5..8c65b259f337d 100644
--- a/docs-website/package.json
+++ b/docs-website/package.json
@@ -35,6 +35,7 @@
     "@octokit/plugin-throttling": "^3.5.1",
     "@octokit/rest": "^18.6.2",
     "@radix-ui/react-visually-hidden": "^1.0.2",
+    "@servicebell/widget": "^0.1.6",
     "@supabase/supabase-js": "^2.33.1",
     "@swc/core": "^1.4.2",
     "antd": "^5.0.7",
diff --git a/docs-website/src/pages/cloud/index.js b/docs-website/src/pages/cloud/index.js
index 6e126adc4cb3a..377fe0aa6475e 100644
--- a/docs-website/src/pages/cloud/index.js
+++ b/docs-website/src/pages/cloud/index.js
@@ -1,4 +1,4 @@
-import React, { useState } from "react";
+import React, { useEffect, useState } from "react";
 import Layout from "@theme/Layout";
 import Link from "@docusaurus/Link";
 import useDocusaurusContext from "@docusaurus/useDocusaurusContext";
@@ -10,8 +10,11 @@ import UnifiedTabs from "./UnifiedTabs";
 import FeatureCards from "./FeatureCards";
 import Hero from "./Hero";
 import DemoForm from "./DemoForm";
+import ServiceBell from "@servicebell/widget";
 import DemoFormModal from "./DemoFormModal";
 
+const SERVICE_BELL_ID = "00892146e5bc46d98d55ecc2b2fa67e2";
+
 function Home() {
   const context = useDocusaurusContext();
   const { siteConfig = {} } = context;
@@ -24,6 +27,10 @@ function Home() {
     window.location.replace("/docs");
   }
 
+  useEffect(() => {
+    ServiceBell("init", SERVICE_BELL_ID, { hidden: false });
+  }, []);
+
   return !siteConfig.customFields.isSaas ? (
     <Layout
       title={'DataHub Cloud - Unify Data Observability, Governance and Discovery'}
diff --git a/docs-website/src/theme/Footer/index.js b/docs-website/src/theme/Footer/index.js
index 74e6eb7d09a7b..fe0086993ee9e 100644
--- a/docs-website/src/theme/Footer/index.js
+++ b/docs-website/src/theme/Footer/index.js
@@ -1,11 +1,15 @@
 import React from "react";
+import { useLocation } from "react-router-dom"; // Import useLocation from react-router-dom
 import Footer from "@theme-original/Footer";
 import MarkpromptHelp from "../../components/MarkpromptHelp";
 
 export default function FooterWrapper(props) {
+  const location = useLocation(); // Get the current location
+  const isDocsPage = location.pathname.startsWith("/docs"); // Check if the path starts with /docs
+
   return (
     <>
-      <MarkpromptHelp />
+      {isDocsPage && <MarkpromptHelp />}
       <Footer {...props} />
     </>
   );
diff --git a/docs-website/yarn.lock b/docs-website/yarn.lock
index 0c4f2358d7139..1b7e31fdc0f3d 100644
--- a/docs-website/yarn.lock
+++ b/docs-website/yarn.lock
@@ -2843,6 +2843,11 @@
     rc-resize-observer "^1.3.1"
     rc-util "^5.38.0"
 
+"@servicebell/widget@^0.1.6":
+  version "0.1.6"
+  resolved "https://registry.yarnpkg.com/@servicebell/widget/-/widget-0.1.6.tgz#04672a7e7b14ff7025ec83fd740373345c359d74"
+  integrity sha512-Kh21FAETJlk32MRXHGYKxFTWLbbLlgLX3lKYH/02KHaQGIPRdHh/Ok7DiRc+/6f/OTQq3x3ady7e4o9weV5yQg==
+
 "@sideway/address@^4.1.5":
   version "4.1.5"
   resolved "https://registry.yarnpkg.com/@sideway/address/-/address-4.1.5.tgz#4bc149a0076623ced99ca8208ba780d65a99b9d5"

From 1f02c84480f157f99a83a6217e008ab5ce7773cd Mon Sep 17 00:00:00 2001
From: Aseem Bansal <asmbansal2@gmail.com>
Date: Mon, 4 Nov 2024 16:16:23 +0530
Subject: [PATCH 16/21] feat(ingest/cli): add undo soft delete command (#11740)

---
 .../src/datahub/cli/delete_cli.py               | 11 +++++++++++
 .../src/datahub/ingestion/graph/client.py       | 17 ++++++++++++++++-
 2 files changed, 27 insertions(+), 1 deletion(-)

diff --git a/metadata-ingestion/src/datahub/cli/delete_cli.py b/metadata-ingestion/src/datahub/cli/delete_cli.py
index 584bfc1f7cda5..8b852513e03c0 100644
--- a/metadata-ingestion/src/datahub/cli/delete_cli.py
+++ b/metadata-ingestion/src/datahub/cli/delete_cli.py
@@ -213,6 +213,17 @@ def references(urn: str, dry_run: bool, force: bool) -> None:
         logger.info(f"Deleted {references_count} references to {urn}")
 
 
+@delete.command()
+@click.option("--urn", required=True, type=str, help="the urn of the entity")
+def undo_by_filter(urn: str) -> None:
+    """
+    Undo a soft deletion of an entity
+    """
+    graph = get_default_graph()
+    logger.info(f"Using {graph}")
+    graph.set_soft_delete_status(urn=urn, delete=False)
+
+
 @delete.command(no_args_is_help=True)
 @click.option(
     "--urn",
diff --git a/metadata-ingestion/src/datahub/ingestion/graph/client.py b/metadata-ingestion/src/datahub/ingestion/graph/client.py
index 1d2528a24c4e5..c90ac93eee2cc 100644
--- a/metadata-ingestion/src/datahub/ingestion/graph/client.py
+++ b/metadata-ingestion/src/datahub/ingestion/graph/client.py
@@ -1241,14 +1241,29 @@ def soft_delete_entity(
         Args:
             urn: The urn of the entity to soft-delete.
         """
+        self.set_soft_delete_status(
+            urn=urn, run_id=run_id, deletion_timestamp=deletion_timestamp, delete=True
+        )
+
+    def set_soft_delete_status(
+        self,
+        urn: str,
+        delete: bool,
+        run_id: str = _GRAPH_DUMMY_RUN_ID,
+        deletion_timestamp: Optional[int] = None,
+    ) -> None:
+        """Change status of soft-delete an entity by urn.
 
+        Args:
+            urn: The urn of the entity to soft-delete.
+        """
         assert urn
 
         deletion_timestamp = deletion_timestamp or int(time.time() * 1000)
         self.emit(
             MetadataChangeProposalWrapper(
                 entityUrn=urn,
-                aspect=StatusClass(removed=True),
+                aspect=StatusClass(removed=delete),
                 systemMetadata=SystemMetadataClass(
                     runId=run_id, lastObserved=deletion_timestamp
                 ),

From e53a54edcb67d95e47f44962a08da8b42ab27e37 Mon Sep 17 00:00:00 2001
From: Jay <159848059+jayacryl@users.noreply.github.com>
Date: Mon, 4 Nov 2024 17:39:54 -0500
Subject: [PATCH 17/21] fix(docs-site) improvements to home page (#11783)

---
 docs-website/adoptionStoriesIndexes.json       |  10 ++++++++++
 docs-website/docusaurus.config.js              |   4 ++--
 docs-website/package.json                      |   1 +
 .../CaseStudy/case-study.module.scss           |   5 +++++
 .../_components/CaseStudy/caseStudyContent.js  |  10 ++++++++++
 .../src/pages/_components/CaseStudy/index.js   |  16 ++++++++++------
 .../adoption-stories-apple.png                 | Bin 0 -> 133699 bytes
 .../static/img/logos/companies/apple_text.png  | Bin 0 -> 8086 bytes
 docs-website/yarn.lock                         |  15 ++++++---------
 9 files changed, 44 insertions(+), 17 deletions(-)
 create mode 100644 docs-website/static/img/adoption-stories/adoption-stories-apple.png
 create mode 100644 docs-website/static/img/logos/companies/apple_text.png

diff --git a/docs-website/adoptionStoriesIndexes.json b/docs-website/adoptionStoriesIndexes.json
index f7b78e6cab8b2..618cd4bbb3334 100644
--- a/docs-website/adoptionStoriesIndexes.json
+++ b/docs-website/adoptionStoriesIndexes.json
@@ -20,6 +20,16 @@
       "category": "Financial & Fintech",
       "description": "<i>\"We found DataHub to provide excellent coverage for our needs. What we appreciate most about DataHub is <b>its powerful API platform.</b>\"<br /><br /><div style='color: gray;'>— Jean-Pierre Dijcks, Sr. Dir. Product Management at VISA</div></i><br />"
     },
+    {
+      "name": "Apple",
+      "slug": "apple",
+      "link": "https://youtu.be/5eFZuzG4c-s?feature=shared",
+      "linkType": "video",
+      "tagline": "How Apple built a solid foundation for observability, governance, and data sharing with DataHub",
+      "category": "B2B & B2C",
+      "platform": "cloud",
+      "description": "Discover how DataHub provides a solid foundation for observability, governance, and data sharing, while we explore its role in managing AI and data metadata."
+    },
     {
       "name": "Notion",
       "slug": "notion",
diff --git a/docs-website/docusaurus.config.js b/docs-website/docusaurus.config.js
index 8c44b3c8b40bf..31644f459ed73 100644
--- a/docs-website/docusaurus.config.js
+++ b/docs-website/docusaurus.config.js
@@ -66,9 +66,9 @@ module.exports = {
     //   },
     // }),
     announcementBar: {
-          id: "announcement-2",
+          id: "announcement-3",
           content:
-            '<div style="display: flex; justify-content: center; align-items: center;width: 100%;"><!--img src="/img/acryl-logo-white-mark.svg" / --><div style="font-size: .8rem; font-weight: 600; background-color: white; color: #111; padding: 0px 8px; border-radius: 4px; margin-right:12px;">NEW</div><p>Join us at Metadata & AI Summit, Oct. 29 & 30!</p><a href="http://www.acryldata.io/conference?utm_source=datahub_web&utm_medium=metadata_ai_2024&utm_campaign=home_banner" target="_blank" class="button">Register<span> →</span></a></div>',
+            '<div style="display: flex; justify-content: center; align-items: center;width: 100%;"><!--img src="/img/acryl-logo-white-mark.svg" / --><!--div style="font-size: .8rem; font-weight: 600; background-color: white; color: #111; padding: 0px 8px; border-radius: 4px; margin-right:12px;">NEW</div--><p>Watch Metadata & AI Summit sessions on-demand.</p><a href="https://www.youtube.com/@DataHubProject/videos" target="_blank" class="button">Watch Now<span> →</span></a></div>',
           backgroundColor: "#111",
           textColor: "#ffffff",
           isCloseable: false,
diff --git a/docs-website/package.json b/docs-website/package.json
index 8c65b259f337d..52f04e46c42aa 100644
--- a/docs-website/package.json
+++ b/docs-website/package.json
@@ -48,6 +48,7 @@
     "markprompt": "^0.1.7",
     "react": "^18.2.0",
     "react-dom": "18.2.0",
+    "react-use-draggable-scroll": "^0.4.7",
     "sass": "^1.43.2",
     "swc-loader": "^0.2.6",
     "swiper": "^11.1.4",
diff --git a/docs-website/src/pages/_components/CaseStudy/case-study.module.scss b/docs-website/src/pages/_components/CaseStudy/case-study.module.scss
index e17f1f74656dc..29cade9901c4d 100644
--- a/docs-website/src/pages/_components/CaseStudy/case-study.module.scss
+++ b/docs-website/src/pages/_components/CaseStudy/case-study.module.scss
@@ -42,6 +42,9 @@
       flex: 1;
     }
     .cardLink {
+      user-select: none;
+      -webkit-user-drag: none;
+
       color: #000;
       
       &:hover {
@@ -88,6 +91,8 @@
           z-index: 10;
           filter: brightness(2);
           opacity: .9;
+          user-select: none;
+          -webkit-user-drag: none;
         }
         .cardImageBackground {
           position: absolute;
diff --git a/docs-website/src/pages/_components/CaseStudy/caseStudyContent.js b/docs-website/src/pages/_components/CaseStudy/caseStudyContent.js
index 3c840e4fab6eb..4bb1b769b288a 100644
--- a/docs-website/src/pages/_components/CaseStudy/caseStudyContent.js
+++ b/docs-website/src/pages/_components/CaseStudy/caseStudyContent.js
@@ -9,6 +9,16 @@ const caseStudyData = [
     image: "https://datahubproject.io/img/logos/companies/netflix.png",
     link: "https://datahubproject.io/adoption-stories/#netflix",
   },
+  {
+    title: "A Solid Foundation For Data and AI",
+    description:
+      "How Apple built a solid foundation for observability, governance, and data sharing with DataHub.",
+    tag: "Technology",
+    backgroundImage:
+      "https://upload.wikimedia.org/wikipedia/commons/thumb/5/5a/Aerial_view_of_Apple_Park_dllu.jpg/2560px-Aerial_view_of_Apple_Park_dllu.jpg",
+    image: "/img/logos/companies/apple_text.png",
+    link: "https://datahubproject.io/adoption-stories/#apple",
+  },
   {
     title: "Scaling Data Governance",
     description:
diff --git a/docs-website/src/pages/_components/CaseStudy/index.js b/docs-website/src/pages/_components/CaseStudy/index.js
index 0362dec9a0d3e..27766a8456a6f 100644
--- a/docs-website/src/pages/_components/CaseStudy/index.js
+++ b/docs-website/src/pages/_components/CaseStudy/index.js
@@ -1,11 +1,15 @@
-import React from "react";
+import React, { useRef } from "react";
 import styles from "./case-study.module.scss";
 import Link from '@docusaurus/Link'
-import { Carousel } from "antd";
+import { useDraggable } from "react-use-draggable-scroll";
 import caseStudyData from "./caseStudyContent";
 
 
 const CaseStudy = () => {
+  const containerRef = useRef(null);
+
+  const { events } = useDraggable(containerRef);
+
   return (
     <div className={styles.container}>
       {/* Section-1 */}
@@ -15,16 +19,16 @@ const CaseStudy = () => {
           <p>Across finance, healthcare, e-commerce, and countless more.</p>
         </div>
 
-        <div className={styles.card_row}>
-          <div className={styles.card_row_wrapper} >
+        <div className={styles.card_row} {...events} ref={containerRef}>
+          <div className={styles.card_row_wrapper}>
             {caseStudyData.map((caseStudy) => (
               <div className={styles.card} key={caseStudy.link}>
-                <a className={styles.cardLink} href={caseStudy.link} style={caseStudy.backgroundImage ? null : {
+                <a draggable={false} className={styles.cardLink} href={caseStudy.link} style={caseStudy.backgroundImage ? null : {
                   opacity: .5
                 }}>
                   {caseStudy.tag ? <span className={styles.card_tag}>{caseStudy.tag}</span> : null}
                   <div className={styles.card_image} style={{ backgroundColor: caseStudy.backgroundImage ? null : '#eee' }}>
-                    <img src={caseStudy.image} alt="" />
+                    <img src={caseStudy.image} draggable={false} alt="" />
                     <div className={styles.cardImageBackground} style={{ backgroundImage: `url(${caseStudy.backgroundImage})` }} />
                   </div>
                   <div className={styles.card_heading_div}>
diff --git a/docs-website/static/img/adoption-stories/adoption-stories-apple.png b/docs-website/static/img/adoption-stories/adoption-stories-apple.png
new file mode 100644
index 0000000000000000000000000000000000000000..7ca5b06300abc53ece7905c4bc5de911d1609f68
GIT binary patch
literal 133699
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
JR!Ex%{vT#~Jy!q#

literal 0
HcmV?d00001

diff --git a/docs-website/static/img/logos/companies/apple_text.png b/docs-website/static/img/logos/companies/apple_text.png
new file mode 100644
index 0000000000000000000000000000000000000000..59ede054a96db539e95c169f3d23efeac7bf74d5
GIT binary patch
literal 8086
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
TYV~F1-&)N_u!kiNY(xJKp<>*q

literal 0
HcmV?d00001

diff --git a/docs-website/yarn.lock b/docs-website/yarn.lock
index 1b7e31fdc0f3d..4e457abd50af7 100644
--- a/docs-website/yarn.lock
+++ b/docs-website/yarn.lock
@@ -1827,7 +1827,7 @@
     "@docusaurus/theme-search-algolia" "2.4.3"
     "@docusaurus/types" "2.4.3"
 
-"@docusaurus/react-loadable@5.5.2":
+"@docusaurus/react-loadable@5.5.2", "react-loadable@npm:@docusaurus/react-loadable@5.5.2":
   version "5.5.2"
   resolved "https://registry.yarnpkg.com/@docusaurus/react-loadable/-/react-loadable-5.5.2.tgz#81aae0db81ecafbdaee3651f12804580868fa6ce"
   integrity sha512-A3dYjdBGuy0IGT+wyLIGIKLRE+sAk1iNk0f1HjNDysO7u8lhL4N3VEm+FAubmJbAztn94F7MxBTPmnixbiyFdQ==
@@ -9713,14 +9713,6 @@ react-loadable-ssr-addon-v5-slorber@^1.0.1:
   dependencies:
     "@babel/runtime" "^7.10.3"
 
-"react-loadable@npm:@docusaurus/react-loadable@5.5.2":
-  version "5.5.2"
-  resolved "https://registry.yarnpkg.com/@docusaurus/react-loadable/-/react-loadable-5.5.2.tgz#81aae0db81ecafbdaee3651f12804580868fa6ce"
-  integrity sha512-A3dYjdBGuy0IGT+wyLIGIKLRE+sAk1iNk0f1HjNDysO7u8lhL4N3VEm+FAubmJbAztn94F7MxBTPmnixbiyFdQ==
-  dependencies:
-    "@types/react" "*"
-    prop-types "^15.6.2"
-
 react-markdown@^8.0.6:
   version "8.0.7"
   resolved "https://registry.yarnpkg.com/react-markdown/-/react-markdown-8.0.7.tgz#c8dbd1b9ba5f1c5e7e5f2a44de465a3caafdf89b"
@@ -9835,6 +9827,11 @@ react-textarea-autosize@^8.3.2:
     use-composed-ref "^1.3.0"
     use-latest "^1.2.1"
 
+react-use-draggable-scroll@^0.4.7:
+  version "0.4.7"
+  resolved "https://registry.yarnpkg.com/react-use-draggable-scroll/-/react-use-draggable-scroll-0.4.7.tgz#86e77caab921ca07b134e9e1d1bc1810aeee4916"
+  integrity sha512-6gCxGPO9WV5dIsBaDrgUKBaac8CY07PkygcArfajijYSNDwAq0girDRjaBuF1+lRqQryoLFQfpVaV2u/Yh6CrQ==
+
 react-waypoint@^10.3.0:
   version "10.3.0"
   resolved "https://registry.yarnpkg.com/react-waypoint/-/react-waypoint-10.3.0.tgz#fcc60e86c6c9ad2174fa58d066dc6ae54e3df71d"

From e706d1511b21419faf8d933e056b5cb837343a7a Mon Sep 17 00:00:00 2001
From: noggi <anton.kuraev@acryl.io>
Date: Mon, 4 Nov 2024 17:26:28 -0800
Subject: [PATCH 18/21] Make DatahubGC bootstrap MCP non-optional (#11785)

---
 .../upgrade/system/bootstrapmcps/BootstrapMCPUtilTest.java    | 2 +-
 .../configuration/src/main/resources/bootstrap_mcps.yaml      | 4 ++--
 .../main/resources/bootstrap_mcps/ingestion-datahub-gc.yaml   | 2 +-
 3 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/datahub-upgrade/src/test/java/com/linkedin/datahub/upgrade/system/bootstrapmcps/BootstrapMCPUtilTest.java b/datahub-upgrade/src/test/java/com/linkedin/datahub/upgrade/system/bootstrapmcps/BootstrapMCPUtilTest.java
index 68023a084bbd2..b471e366e906f 100644
--- a/datahub-upgrade/src/test/java/com/linkedin/datahub/upgrade/system/bootstrapmcps/BootstrapMCPUtilTest.java
+++ b/datahub-upgrade/src/test/java/com/linkedin/datahub/upgrade/system/bootstrapmcps/BootstrapMCPUtilTest.java
@@ -219,6 +219,6 @@ public void testMCPBatch() throws IOException {
         OP_CONTEXT
             .getObjectMapper()
             .readTree(
-                "{\"source\":{\"type\":\"datahub-gc\",\"config\":{\"cleanup_expired_tokens\":false,\"truncate_indices\":true,\"dataprocess_cleanup\":{\"retention_days\":10,\"delete_empty_data_jobs\":true,\"delete_empty_data_flows\":true,\"hard_delete_entities\":false,\"keep_last_n\":5},\"soft_deleted_entities_cleanup\":{\"retention_days\":10}}}}"));
+                "{\"source\":{\"type\":\"datahub-gc\",\"config\":{\"cleanup_expired_tokens\":false,\"truncate_indices\":true,\"dataprocess_cleanup\":{\"retention_days\":10,\"delete_empty_data_jobs\":true,\"delete_empty_data_flows\":true,\"hard_delete_entities\":false,\"keep_last_n\":5},\"soft_deleted_entities_cleanup\":{\"retention_days\":10},\"execution_request_cleanup\":{\"keep_history_min_count\":10,\"keep_history_max_count\":1000,\"keep_history_max_days\":30,\"batch_read_size\":100,\"enabled\":false}}}}"));
   }
 }
diff --git a/metadata-service/configuration/src/main/resources/bootstrap_mcps.yaml b/metadata-service/configuration/src/main/resources/bootstrap_mcps.yaml
index dda79120118e5..3ce335fc667e7 100644
--- a/metadata-service/configuration/src/main/resources/bootstrap_mcps.yaml
+++ b/metadata-service/configuration/src/main/resources/bootstrap_mcps.yaml
@@ -38,7 +38,7 @@ bootstrap:
 
     # Ingestion Recipes
     - name: ingestion-datahub-gc
-      version: v2
-      optional: true
+      version: v3
+      optional: false
       mcps_location: "bootstrap_mcps/ingestion-datahub-gc.yaml"
       values_env: "DATAHUB_GC_BOOTSTRAP_VALUES"
diff --git a/metadata-service/configuration/src/main/resources/bootstrap_mcps/ingestion-datahub-gc.yaml b/metadata-service/configuration/src/main/resources/bootstrap_mcps/ingestion-datahub-gc.yaml
index f30ce148ec6cb..2c99d0d884ddf 100644
--- a/metadata-service/configuration/src/main/resources/bootstrap_mcps/ingestion-datahub-gc.yaml
+++ b/metadata-service/configuration/src/main/resources/bootstrap_mcps/ingestion-datahub-gc.yaml
@@ -33,7 +33,7 @@
               keep_history_max_days: {{execution_request_cleanup.keep_history_max_days}}{{^execution_request_cleanup.keep_history_max_days}}30{{/execution_request_cleanup.keep_history_max_days}}
               batch_read_size: {{execution_request_cleanup.batch_read_size}}{{^execution_request_cleanup.batch_read_size}}100{{/execution_request_cleanup.batch_read_size}}
               enabled: {{execution_request_cleanup.enabled}}{{^execution_request_cleanup.enabled}}false{{/execution_request_cleanup.enabled}}
-    extraArgs: {}
+      extraArgs: {}
       debugMode: false
       executorId: default
     source:

From a67981beda329ab68db07bb089bdfee24e06263f Mon Sep 17 00:00:00 2001
From: Harshal Sheth <hsheth2@gmail.com>
Date: Tue, 5 Nov 2024 00:06:07 -0800
Subject: [PATCH 19/21] fix(ingest/redshift): fix unload lineage in lineage_v2
 (#11620)

Co-authored-by: Tamas Nemeth <treff7es@gmail.com>
---
 .../ingestion/source/redshift/lineage_v2.py   | 22 ++++++++--------
 .../sql_parsing/sql_parsing_aggregator.py     | 25 ++++++++++++++-----
 2 files changed, 31 insertions(+), 16 deletions(-)

diff --git a/metadata-ingestion/src/datahub/ingestion/source/redshift/lineage_v2.py b/metadata-ingestion/src/datahub/ingestion/source/redshift/lineage_v2.py
index e7cc5fc50cf6e..4b84c25965a99 100644
--- a/metadata-ingestion/src/datahub/ingestion/source/redshift/lineage_v2.py
+++ b/metadata-ingestion/src/datahub/ingestion/source/redshift/lineage_v2.py
@@ -57,6 +57,7 @@ def __init__(
         self.context = context
 
         self.database = database
+        self.known_urns: Set[str] = set()  # will be set later
 
         self.aggregator = SqlParsingAggregator(
             platform=self.platform,
@@ -68,6 +69,7 @@ def __init__(
             generate_operations=False,
             usage_config=self.config,
             graph=self.context.graph,
+            is_temp_table=self._is_temp_table,
         )
         self.report.sql_aggregator = self.aggregator.report
 
@@ -87,7 +89,16 @@ def __init__(
             self.report.lineage_end_time,
         ) = self._lineage_v1.get_time_window()
 
-        self.known_urns: Set[str] = set()  # will be set later
+    def _is_temp_table(self, name: str) -> bool:
+        return (
+            DatasetUrn.create_from_ids(
+                self.platform,
+                name,
+                env=self.config.env,
+                platform_instance=self.config.platform_instance,
+            ).urn()
+            not in self.known_urns
+        )
 
     def build(
         self,
@@ -107,15 +118,6 @@ def build(
             for schema, tables in schemas.items()
             for table in tables
         }
-        self.aggregator._is_temp_table = (
-            lambda name: DatasetUrn.create_from_ids(
-                self.platform,
-                name,
-                env=self.config.env,
-                platform_instance=self.config.platform_instance,
-            ).urn()
-            not in self.known_urns
-        )
 
         # Handle all the temp tables up front.
         if self.config.resolve_temp_table_in_lineage:
diff --git a/metadata-ingestion/src/datahub/sql_parsing/sql_parsing_aggregator.py b/metadata-ingestion/src/datahub/sql_parsing/sql_parsing_aggregator.py
index 5c3a6b5b533a0..f0496379c45b8 100644
--- a/metadata-ingestion/src/datahub/sql_parsing/sql_parsing_aggregator.py
+++ b/metadata-ingestion/src/datahub/sql_parsing/sql_parsing_aggregator.py
@@ -537,8 +537,13 @@ def _maybe_format_query(self, query: str) -> str:
         return query
 
     @functools.lru_cache(maxsize=128)
-    def _name_from_urn(self, urn: UrnStr) -> str:
-        name = DatasetUrn.from_string(urn).name
+    def _name_from_urn(self, urn: UrnStr) -> Optional[str]:
+        urn_obj = DatasetUrn.from_string(urn)
+        if urn_obj.platform != self.platform.urn():
+            # If this is external (e.g. s3), we don't know the name.
+            return None
+
+        name = urn_obj.name
         if (
             platform_instance := self._schema_resolver.platform_instance
         ) and name.startswith(platform_instance):
@@ -549,14 +554,22 @@ def _name_from_urn(self, urn: UrnStr) -> str:
     def is_temp_table(self, urn: UrnStr) -> bool:
         if self._is_temp_table is None:
             return False
-        return self._is_temp_table(self._name_from_urn(urn))
+        name = self._name_from_urn(urn)
+        if name is None:
+            # External tables are not temp tables.
+            return False
+        return self._is_temp_table(name)
 
-    def is_allowed_table(self, urn: UrnStr) -> bool:
+    def is_allowed_table(self, urn: UrnStr, allow_external: bool = True) -> bool:
         if self.is_temp_table(urn):
             return False
         if self._is_allowed_table is None:
             return True
-        return self._is_allowed_table(self._name_from_urn(urn))
+        name = self._name_from_urn(urn)
+        if name is None:
+            # Treat external tables specially.
+            return allow_external
+        return self._is_allowed_table(name)
 
     def add(
         self,
@@ -852,7 +865,7 @@ def add_preparsed_query(
             upstream_fields = parsed.column_usage or {}
             for upstream_urn in parsed.upstreams:
                 # If the upstream table is a temp table or otherwise denied by filters, don't log usage for it.
-                if not self.is_allowed_table(upstream_urn) or (
+                if not self.is_allowed_table(upstream_urn, allow_external=False) or (
                     require_out_table_schema
                     and not self._schema_resolver.has_urn(upstream_urn)
                 ):

From 83ec73b7d11aeac5d91b26dbb602b9783819a3bf Mon Sep 17 00:00:00 2001
From: Tamas Nemeth <treff7es@gmail.com>
Date: Tue, 5 Nov 2024 10:55:35 +0100
Subject: [PATCH 20/21] fix(ingest/openapi): Fix openapi tests (#11789)

---
 .../integration/openapi/openapi_mces_golden.json | 16 ++++++++++------
 .../integration/openapi/openapi_to_file.yml      |  4 ++--
 2 files changed, 12 insertions(+), 8 deletions(-)

diff --git a/metadata-ingestion/tests/integration/openapi/openapi_mces_golden.json b/metadata-ingestion/tests/integration/openapi/openapi_mces_golden.json
index ad270857dd7fc..ffa8d43a6a5ab 100755
--- a/metadata-ingestion/tests/integration/openapi/openapi_mces_golden.json
+++ b/metadata-ingestion/tests/integration/openapi/openapi_mces_golden.json
@@ -20,7 +20,7 @@
                     "com.linkedin.pegasus2avro.common.InstitutionalMemory": {
                         "elements": [
                             {
-                                "url": "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/",
+                                "url": "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/tests/",
                                 "description": "Link to call for the dataset.",
                                 "createStamp": {
                                     "time": 1586847600,
@@ -71,7 +71,8 @@
     },
     "systemMetadata": {
         "lastObserved": 1586847600000,
-        "runId": "openapi-2020_04_14-07_00_00"
+        "runId": "openapi-2020_04_14-07_00_00-m1k7d5",
+        "lastRunId": "no-run-id-provided"
     }
 },
 {
@@ -95,7 +96,7 @@
                     "com.linkedin.pegasus2avro.common.InstitutionalMemory": {
                         "elements": [
                             {
-                                "url": "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/v2",
+                                "url": "https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/tests/v2",
                                 "description": "Link to call for the dataset.",
                                 "createStamp": {
                                     "time": 1586847600,
@@ -146,7 +147,8 @@
     },
     "systemMetadata": {
         "lastObserved": 1586847600000,
-        "runId": "openapi-2020_04_14-07_00_00"
+        "runId": "openapi-2020_04_14-07_00_00-m1k7d5",
+        "lastRunId": "no-run-id-provided"
     }
 },
 {
@@ -161,7 +163,8 @@
     },
     "systemMetadata": {
         "lastObserved": 1586847600000,
-        "runId": "openapi-2020_04_14-07_00_00"
+        "runId": "openapi-2020_04_14-07_00_00-m1k7d5",
+        "lastRunId": "no-run-id-provided"
     }
 },
 {
@@ -176,7 +179,8 @@
     },
     "systemMetadata": {
         "lastObserved": 1586847600000,
-        "runId": "openapi-2020_04_14-07_00_00"
+        "runId": "openapi-2020_04_14-07_00_00-m1k7d5",
+        "lastRunId": "no-run-id-provided"
     }
 }
 ]
\ No newline at end of file
diff --git a/metadata-ingestion/tests/integration/openapi/openapi_to_file.yml b/metadata-ingestion/tests/integration/openapi/openapi_to_file.yml
index e9dc03482c2bc..8575c23239461 100644
--- a/metadata-ingestion/tests/integration/openapi/openapi_to_file.yml
+++ b/metadata-ingestion/tests/integration/openapi/openapi_to_file.yml
@@ -2,8 +2,8 @@ source:
   type: openapi
   config:
     name: test_openapi
-    url: https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/examples/
-    swagger_file: v3.0/api-with-examples.yaml
+    url: https://raw.githubusercontent.com/OAI/OpenAPI-Specification/main/tests/
+    swagger_file: v3.0/pass/api-with-examples.yaml
 
 
 sink:

From edb87ff2ea896abdfaeba483a573e20f25917bd7 Mon Sep 17 00:00:00 2001
From: ronybony1990 <33382997+ronybony1990@users.noreply.github.com>
Date: Tue, 5 Nov 2024 03:18:15 -0700
Subject: [PATCH 21/21] feat(spark-plugin): user should be able to pass custom
 mcp kafka topic (#11767)

Co-authored-by: Neelab Chaudhuri <nchaudhuri@fanatics.com>
---
 .../datahub/spark/DatahubEventEmitter.java    |  5 ++++-
 .../datahub/spark/DatahubSparkListener.java   |  8 ++++++--
 .../spark/conf/KafkaDatahubEmitterConfig.java |  8 ++++++++
 .../datahub/spark/conf/SparkConfigParser.java |  1 +
 .../datahub/client/kafka/AvroSerializer.java  |  2 +-
 .../datahub/client/kafka/KafkaEmitter.java    | 19 +++++++++++++++----
 6 files changed, 35 insertions(+), 8 deletions(-)

diff --git a/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/DatahubEventEmitter.java b/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/DatahubEventEmitter.java
index 7a5fdeaeb8e0d..0bcc7db9e8740 100644
--- a/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/DatahubEventEmitter.java
+++ b/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/DatahubEventEmitter.java
@@ -82,7 +82,10 @@ private Optional<Emitter> getEmitter() {
             (KafkaDatahubEmitterConfig) datahubConf.getDatahubEmitterConfig();
         try {
           emitter =
-              Optional.of(new KafkaEmitter(datahubKafkaEmitterConfig.getKafkaEmitterConfig()));
+              Optional.of(
+                  new KafkaEmitter(
+                      datahubKafkaEmitterConfig.getKafkaEmitterConfig(),
+                      datahubKafkaEmitterConfig.getMcpTopic()));
         } catch (IOException e) {
           throw new RuntimeException(e);
         }
diff --git a/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/DatahubSparkListener.java b/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/DatahubSparkListener.java
index 52507a682a1f8..ee0938edb5045 100644
--- a/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/DatahubSparkListener.java
+++ b/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/DatahubSparkListener.java
@@ -188,8 +188,12 @@ public Optional<DatahubEmitterConfig> initializeEmitter(Config sparkConf) {
                   });
           kafkaEmitterConfig.producerConfig(kafkaConfig);
         }
-
-        return Optional.of(new KafkaDatahubEmitterConfig(kafkaEmitterConfig.build()));
+        if (sparkConf.hasPath(SparkConfigParser.KAFKA_MCP_TOPIC)) {
+          String mcpTopic = sparkConf.getString(SparkConfigParser.KAFKA_MCP_TOPIC);
+          return Optional.of(new KafkaDatahubEmitterConfig(kafkaEmitterConfig.build(), mcpTopic));
+        } else {
+          return Optional.of(new KafkaDatahubEmitterConfig(kafkaEmitterConfig.build()));
+        }
       case "file":
         log.info("File Emitter Configuration: File emitter will be used");
         FileEmitterConfig.FileEmitterConfigBuilder fileEmitterConfig = FileEmitterConfig.builder();
diff --git a/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/conf/KafkaDatahubEmitterConfig.java b/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/conf/KafkaDatahubEmitterConfig.java
index 6ed66dbc9230f..a5f9b59f70846 100644
--- a/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/conf/KafkaDatahubEmitterConfig.java
+++ b/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/conf/KafkaDatahubEmitterConfig.java
@@ -1,5 +1,6 @@
 package datahub.spark.conf;
 
+import datahub.client.kafka.KafkaEmitter;
 import datahub.client.kafka.KafkaEmitterConfig;
 import lombok.Getter;
 import lombok.Setter;
@@ -11,8 +12,15 @@
 public class KafkaDatahubEmitterConfig implements DatahubEmitterConfig {
   final String type = "kafka";
   KafkaEmitterConfig kafkaEmitterConfig;
+  String mcpTopic;
 
   public KafkaDatahubEmitterConfig(KafkaEmitterConfig kafkaEmitterConfig) {
     this.kafkaEmitterConfig = kafkaEmitterConfig;
+    this.mcpTopic = KafkaEmitter.DEFAULT_MCP_KAFKA_TOPIC;
+  }
+
+  public KafkaDatahubEmitterConfig(KafkaEmitterConfig kafkaEmitterConfig, String mcpTopic) {
+    this.kafkaEmitterConfig = kafkaEmitterConfig;
+    this.mcpTopic = mcpTopic;
   }
 }
diff --git a/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/conf/SparkConfigParser.java b/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/conf/SparkConfigParser.java
index 630f10b08b411..45ec5365d09b3 100644
--- a/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/conf/SparkConfigParser.java
+++ b/metadata-integration/java/acryl-spark-lineage/src/main/java/datahub/spark/conf/SparkConfigParser.java
@@ -32,6 +32,7 @@ public class SparkConfigParser {
   public static final String DISABLE_SSL_VERIFICATION_KEY = "rest.disable_ssl_verification";
   public static final String MAX_RETRIES = "rest.max_retries";
   public static final String RETRY_INTERVAL_IN_SEC = "rest.retry_interval_in_sec";
+  public static final String KAFKA_MCP_TOPIC = "kafka.mcp_topic";
   public static final String KAFKA_EMITTER_BOOTSTRAP = "kafka.bootstrap";
   public static final String KAFKA_EMITTER_SCHEMA_REGISTRY_URL = "kafka.schema_registry_url";
   public static final String KAFKA_EMITTER_SCHEMA_REGISTRY_CONFIG = "kafka.schema_registry_config";
diff --git a/metadata-integration/java/datahub-client/src/main/java/datahub/client/kafka/AvroSerializer.java b/metadata-integration/java/datahub-client/src/main/java/datahub/client/kafka/AvroSerializer.java
index 0d0341562e7dd..e8ceeab696321 100644
--- a/metadata-integration/java/datahub-client/src/main/java/datahub/client/kafka/AvroSerializer.java
+++ b/metadata-integration/java/datahub-client/src/main/java/datahub/client/kafka/AvroSerializer.java
@@ -9,7 +9,7 @@
 import org.apache.avro.generic.GenericData;
 import org.apache.avro.generic.GenericRecord;
 
-class AvroSerializer {
+public class AvroSerializer {
 
   private final Schema _recordSchema;
   private final Schema _genericAspectSchema;
diff --git a/metadata-integration/java/datahub-client/src/main/java/datahub/client/kafka/KafkaEmitter.java b/metadata-integration/java/datahub-client/src/main/java/datahub/client/kafka/KafkaEmitter.java
index d00dc09669045..777d2d5f301d7 100644
--- a/metadata-integration/java/datahub-client/src/main/java/datahub/client/kafka/KafkaEmitter.java
+++ b/metadata-integration/java/datahub-client/src/main/java/datahub/client/kafka/KafkaEmitter.java
@@ -31,14 +31,25 @@ public class KafkaEmitter implements Emitter {
   private final Properties kafkaConfigProperties;
   private AvroSerializer _avroSerializer;
   private static final int ADMIN_CLIENT_TIMEOUT_MS = 5000;
+  private final String mcpKafkaTopic;
 
   /**
    * The default constructor
    *
-   * @param config
-   * @throws IOException
+   * @param config KafkaEmitterConfig
+   * @throws IOException when Avro Serialization fails
    */
   public KafkaEmitter(KafkaEmitterConfig config) throws IOException {
+    this(config, DEFAULT_MCP_KAFKA_TOPIC);
+  }
+
+  /**
+   * Constructor that takes in KafkaEmitterConfig and mcp Kafka Topic Name
+   *
+   * @param config KafkaEmitterConfig
+   * @throws IOException when Avro Serialization fails
+   */
+  public KafkaEmitter(KafkaEmitterConfig config, String mcpKafkaTopic) throws IOException {
     this.config = config;
     kafkaConfigProperties = new Properties();
     kafkaConfigProperties.put(ProducerConfig.BOOTSTRAP_SERVERS_CONFIG, this.config.getBootstrap());
@@ -54,6 +65,7 @@ public KafkaEmitter(KafkaEmitterConfig config) throws IOException {
 
     producer = new KafkaProducer<>(kafkaConfigProperties);
     _avroSerializer = new AvroSerializer();
+    this.mcpKafkaTopic = mcpKafkaTopic;
   }
 
   @Override
@@ -73,8 +85,7 @@ public Future<MetadataWriteResponse> emit(MetadataChangeProposal mcp, Callback d
       throws IOException {
     GenericRecord genricRecord = _avroSerializer.serialize(mcp);
     ProducerRecord<Object, Object> record =
-        new ProducerRecord<>(
-            KafkaEmitter.DEFAULT_MCP_KAFKA_TOPIC, mcp.getEntityUrn().toString(), genricRecord);
+        new ProducerRecord<>(this.mcpKafkaTopic, mcp.getEntityUrn().toString(), genricRecord);
     org.apache.kafka.clients.producer.Callback callback =
         new org.apache.kafka.clients.producer.Callback() {