castor-extractor 0.25.7__tar.gz → 0.25.9__tar.gz

{castor_extractor-0.25.7 → castor_extractor-0.25.9}/CHANGELOG.md

@@ -1,5 +1,15 @@
 # Changelog
 
+## 0.25.9 - 2025-10-09
+
+* Snowflake: raise an exception when no database is available for extraction
+* Databricks: raise an exception when no database is available for extraction
+* BigQuery: raise an exception when no project is available for extraction
+
+## 0.25.8 - 2025-10-09
+
+* Count: extracting queries and canvas_loads
+
 ## 0.25.7 - 2025-10-07
 
 * SqlServer: Ensure database consistency between query and engine

{castor_extractor-0.25.7 → castor_extractor-0.25.9}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: castor-extractor
-Version: 0.25.7
+Version: 0.25.9
 Summary: Extract your metadata assets.
 Home-page: https://www.castordoc.com/
 License: EULA
@@ -216,6 +216,16 @@ For any questions or bug report, contact us at [support@coalesce.io](mailto:supp
 
 # Changelog
 
+## 0.25.9 - 2025-10-09
+
+* Snowflake: raise an exception when no database is available for extraction
+* Databricks: raise an exception when no database is available for extraction
+* BigQuery: raise an exception when no project is available for extraction
+
+## 0.25.8 - 2025-10-09
+
+* Count: extracting queries and canvas_loads
+
 ## 0.25.7 - 2025-10-07
 
 * SqlServer: Ensure database consistency between query and engine

castor_extractor-0.25.9/castor_extractor/exceptions.py

@@ -0,0 +1,5 @@
+class NoDatabaseProvidedException(Exception):
+    def __init__(self):
+        super().__init__("""No database eligible for extraction.
+If you are using the db_allow/db_block options, please make sure to use the correct case.
+        """)

{castor_extractor-0.25.7 → castor_extractor-0.25.9}/castor_extractor/visualization/count/assets.py

@@ -5,7 +5,9 @@ class CountAsset(ExternalAsset):
     """Count assets"""
 
     CANVASES = "canvases"
+    CANVAS_LOADS = "canvas_loads"
     CANVAS_PERMISSIONS = "canvas_permissions"
     CELLS = "cells"
     PROJECTS = "projects"
+    QUERIES = "queries"
     USERS = "users"

{castor_extractor-0.25.7 → castor_extractor-0.25.9}/castor_extractor/visualization/count/client/client.py

@@ -3,6 +3,7 @@ from dataclasses import asdict
 from typing import Any, Iterator
 
 from ....utils import load_file
+from ....warehouse.abstract import TimeFilter
 from ....warehouse.bigquery import BigQueryClient
 from ..assets import (
     CountAsset,
@@ -27,18 +28,21 @@ class CountClient(BigQueryClient):
         super().__init__(asdict(credentials))
         self.project_id = credentials.project_id
         self.dataset_id = credentials.dataset_id
+        self.time_filter = TimeFilter.default()  # setting current date - 1
 
     def _load_query(self, asset: CountAsset) -> str:
         query = load_file(
             f"{_QUERIES_FOLDER}/{asset.name.lower()}.sql", __file__
         )
         return query.format(
-            project_id=self.project_id, dataset_id=self.dataset_id
+            project_id=self.project_id,
+            dataset_id=self.dataset_id,
+            extract_date=self.time_filter.day,
         )
 
     def fetch(self, asset: CountAsset) -> Iterator[dict[str, Any]]:
         """
-        Fetch the asset given as param, by running a BigQuery query.
+        Fetch the asset given as a param by running a BigQuery query.
         """
         logger.info(f"Running BigQuery query to fetch: {asset.name}")
 

castor_extractor-0.25.9/castor_extractor/visualization/count/client/queries/canvas_loads.sql

@@ -0,0 +1,14 @@
+WITH view_count AS(
+    SELECT
+        canvas_key,
+        DATE(loaded_at) AS load_day
+    FROM `{project_id}.{dataset_id}.canvas_loads`
+    WHERE TRUE
+        AND date(loaded_at) = '{extract_date}'
+)
+
+SELECT
+    canvas_key,
+    COUNT(*) AS view_count
+FROM view_count
+GROUP BY canvas_key

castor_extractor-0.25.9/castor_extractor/visualization/count/client/queries/queries.sql

@@ -0,0 +1,23 @@
+WITH ranked_queries AS (
+    SELECT
+        cell_key,
+        connection_key,
+        query,
+        started_at,
+        ROW_NUMBER() OVER (
+            PARTITION BY cell_key
+            ORDER BY started_at DESC
+        ) AS rank
+    FROM `{project_id}.{dataset_id}.queries`
+    WHERE TRUE
+        AND DATE(started_at) = '{extract_date}'
+)
+
+SELECT
+    cell_key,
+    connection_key,
+    query,
+    started_at
+FROM ranked_queries
+WHERE TRUE
+    AND rank = 1

{castor_extractor-0.25.7 → castor_extractor-0.25.9}/castor_extractor/warehouse/abstract/extract.py

@@ -48,7 +48,7 @@ class SQLExtractionProcessor:
         # dict > set > dict
         return [dict(t) for t in {tuple(d.items()) for d in data}]
 
-    def _fetch(self, query: ExtractionQuery) -> Iterator[dict]:
+    def fetch(self, query: ExtractionQuery) -> Iterator[dict]:
         default: Callable[[], Iterator] = lambda: iter(())  # type: ignore
         decorator = safe_mode(self._safe_mode, default)
         decorated_execute = decorator(self._client.execute)
@@ -62,7 +62,7 @@ class SQLExtractionProcessor:
         for i, query in enumerate(queries):
             logger.info(f"Extracting {asset.value}: query {i + 1}/{total}")
             # concatenate results of all queries
-            data = chain(data, self._fetch(query))
+            data = chain(data, self.fetch(query))
 
         if self._query_builder.needs_deduplication(asset):
             # cast the list to iterator, but the streaming pipeline is broken in that case

{castor_extractor-0.25.7 → castor_extractor-0.25.9}/castor_extractor/warehouse/bigquery/extract.py

@@ -2,6 +2,10 @@ import json
 import logging
 from typing import cast
 
+from castor_extractor.exceptions import (  # type: ignore
+    NoDatabaseProvidedException,
+)
+
 from ...logger import add_logging_file_handler
 from ...utils import LocalStorage, SafeMode, from_env, write_summary
 from ..abstract import (
@@ -62,6 +66,9 @@ def extract_all(**kwargs) -> None:
         db_blocked=kwargs.get("db_blocked"),
         dataset_blocked=kwargs.get("dataset_blocked"),
     )
+    projects = client.get_projects()
+    if not projects:
+        raise NoDatabaseProvidedException
 
     logger.info(f"Available projects: {client.get_projects()}\n")
 

{castor_extractor-0.25.7 → castor_extractor-0.25.9}/castor_extractor/warehouse/databricks/extract.py

@@ -2,6 +2,10 @@ import logging
 from datetime import date
 from typing import Optional
 
+from castor_extractor.exceptions import (  # type: ignore
+    NoDatabaseProvidedException,
+)
+
 from ...utils import AbstractStorage, LocalStorage, write_summary
 from ..abstract import (
     ADDITIONAL_LINEAGE_ASSETS,
@@ -177,6 +181,9 @@ def extract_all(**kwargs) -> None:
         db_blocked=kwargs.get("db_blocked"),
     )
 
+    if not client.databases():
+        raise NoDatabaseProvidedException
+
     storage = LocalStorage(directory=output_directory)
 
     extractor = DatabricksExtractionProcessor(

{castor_extractor-0.25.7 → castor_extractor-0.25.9}/castor_extractor/warehouse/snowflake/extract.py

@@ -1,5 +1,9 @@
 import logging
 
+from castor_extractor.exceptions import (  # type: ignore
+    NoDatabaseProvidedException,
+)
+
 from ...utils import LocalStorage, from_env, write_summary
 from ..abstract import (
     CATALOG_ASSETS,
@@ -60,6 +64,14 @@ def _credentials(params: dict) -> dict:
     raise ValueError("missing password or private key")
 
 
+def _get_database_names(
+    extractor: SQLExtractionProcessor, query_builder: SnowflakeQueryBuilder
+) -> set[str]:
+    db_query = query_builder.build(WarehouseAsset.DATABASE)
+    databases = list(extractor.fetch(db_query[0]))
+    return {db["database_name"] for db in databases}
+
+
 def extract_all(**kwargs) -> None:
     """
     Extract all assets from Snowflake and store the results in CSV files
@@ -85,6 +97,12 @@ def extract_all(**kwargs) -> None:
         storage=storage,
     )
 
+    database_names = _get_database_names(extractor, query_builder)
+    if not database_names:
+        raise NoDatabaseProvidedException
+
+    logger.info(f"Available databases: {database_names}\n")
+
     for group in extractable_asset_groups(SNOWFLAKE_ASSETS):
         for asset in group:
             logger.info(f"Extracting `{asset.value.upper()}` ...")

{castor_extractor-0.25.7 → castor_extractor-0.25.9}/pyproject.toml

@@ -3,7 +3,7 @@ requires = ["setuptools>=61.2"]
 
 [tool.poetry]
 name = "castor-extractor"
-version = "0.25.7"
+version = "0.25.9"
 description = "Extract your metadata assets."
 authors = ["Castor <support@castordoc.com>"]
 license = "EULA"