dc-python-sdk 1.5.43__py3-none-any.whl → 1.5.45__py3-none-any.whl

{dc_python_sdk-1.5.43.dist-info → dc_python_sdk-1.5.45.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: dc-python-sdk
-Version: 1.5.43
+Version: 1.5.45
 Summary: Data Connector Python SDK
 Home-page: https://github.com/data-connector/dc-python-sdk
 Author: DataConnector

{dc_python_sdk-1.5.43.dist-info → dc_python_sdk-1.5.45.dist-info}/RECORD

@@ -1,4 +1,4 @@
-dc_python_sdk-1.5.43.dist-info/licenses/LICENSE,sha256=ACwmltkrXIz5VsEQcrqljq-fat6ZXAMepjXGoe40KtE,1069
+dc_python_sdk-1.5.45.dist-info/licenses/LICENSE,sha256=ACwmltkrXIz5VsEQcrqljq-fat6ZXAMepjXGoe40KtE,1069
 dc_sdk/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 dc_sdk/app.py,sha256=VeGe1q2F71XtZp9VWBUlNowGcF6J-gYsqOu7k2CaeuU,8320
 dc_sdk/cli.py,sha256=fu4ePzpurYO_URvxyaaUuiptOLqiWiwLoieSbKeni3c,891
@@ -9,22 +9,22 @@ dc_sdk/src/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 dc_sdk/src/ai.py,sha256=aIKN6TiBKF8ZJYNpcphwWNqtI34Ni36UipxT-AEyQ1I,23321
 dc_sdk/src/ai_http.py,sha256=9c1X4Sr-2uutTrovHSZVmAacLLwcmFaQ8vA-tOKC0L0,24696
 dc_sdk/src/mapping.py,sha256=NuXrdE1MuRVRT7ILpc86RrVJq60t6Dl_lnlG1A7Ulks,3653
-dc_sdk/src/pipeline.py,sha256=L-C0eKDmSdyZfk3Vqyd6wbC1gCHceH-6xWbfQiLoEiY,21012
+dc_sdk/src/pipeline.py,sha256=nc7sXc-qNHisUQYdONNB7uosrN69ezNzv8fSiQRRNck,27262
 dc_sdk/src/server.py,sha256=2ZhITJhVcj-jd4a-768lAmmmDjTWATGmgwKD-1OVOVI,3028
 dc_sdk/src/models/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
 dc_sdk/src/models/enums.py,sha256=UwUH7Bnu9SMyl_sgkfhrgFsuA7rM-eQV-b0PEjhTs_U,981
 dc_sdk/src/models/errors.py,sha256=uD7EDiQUFUZWjYfowJC4cx6Z0X53UoD1ckh7LD2hcWk,11413
 dc_sdk/src/models/log_templates.py,sha256=gNmU8c9V-fjiraCMSKi3GfojZ6KjJ4EHQst3-G_9OCE,3111
-dc_sdk/src/models/pipeline_details.py,sha256=5xgiFCQyWTwHBfzcg_ALif4gSS-Ou8WNAHhn78s1IpQ,2719
+dc_sdk/src/models/pipeline_details.py,sha256=mZPtPw0X-_dctARCV_i8PJRpHgjl4OMk_bplSNGOltg,2859
 dc_sdk/src/services/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
-dc_sdk/src/services/api.py,sha256=8SUl3nETTQ_8fZdUcWp2sALQ9FyX95-OCypfswljnds,7127
-dc_sdk/src/services/aws.py,sha256=uiKtHoXmcFxeKgsFr_ao-gdlh4fAo1TxtCkhfbpe9JI,9414
+dc_sdk/src/services/api.py,sha256=mXX_ELmHWEUgWpYoEzR010LnXXCyB-RrbTmkMnw9o58,7302
+dc_sdk/src/services/aws.py,sha256=zYAbTAjQ4bAO_YLfPYCVhdNz9SC_nCy4vAm8HdteHwY,9411
 dc_sdk/src/services/environment.py,sha256=lKOuDyzFbjdriPVeVy1GGeuZjutzhwUsZCQcF84XyHM,6447
 dc_sdk/src/services/loader.py,sha256=0zlQm4HOPKffN9Q6YlMv73fCMBsrwkEBnka5rEJTvqU,1175
 dc_sdk/src/services/logger.py,sha256=GrQGfgYfrzmPYFRHkctDSg54jvN7ObveETTPezYldXs,2055
 dc_sdk/src/services/session.py,sha256=SpaZ_qnxMbEZO5fxsbjw6WZXVP5JpncnWalgLqB3MYo,423
-dc_python_sdk-1.5.43.dist-info/METADATA,sha256=ON-ZyZ9xpuKYoBHpGHb_57U67IdKrcmW3tDnhyRUkU0,15980
-dc_python_sdk-1.5.43.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
-dc_python_sdk-1.5.43.dist-info/entry_points.txt,sha256=HSIKPlg7qer7Atu8oOKVpptahi_ZxqfJE-Bh2bmVSss,43
-dc_python_sdk-1.5.43.dist-info/top_level.txt,sha256=gD_FZnF6mZfFU5EmdB2knYHDHKfH5kXJMtSgEZga3BI,7
-dc_python_sdk-1.5.43.dist-info/RECORD,,
+dc_python_sdk-1.5.45.dist-info/METADATA,sha256=syZWEl2LAbT7SEs1eMhok9MhIGvle5FL8pWslPDAVA0,15980
+dc_python_sdk-1.5.45.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+dc_python_sdk-1.5.45.dist-info/entry_points.txt,sha256=HSIKPlg7qer7Atu8oOKVpptahi_ZxqfJE-Bh2bmVSss,43
+dc_python_sdk-1.5.45.dist-info/top_level.txt,sha256=gD_FZnF6mZfFU5EmdB2knYHDHKfH5kXJMtSgEZga3BI,7
+dc_python_sdk-1.5.45.dist-info/RECORD,,

dc_sdk/src/models/pipeline_details.py

@@ -32,9 +32,11 @@ class PipelineDetails:
         self.destination_ecs_task_version_nbr = row_data['destination_ecs_task_version_nbr']
         self.options = json.loads(row_data['pipeline_object_options_json']) if 'pipeline_object_options_json' in row_data and row_data['pipeline_object_options_json'] else dict()
         self.max_allowed_retrieval = row_data.get('max_allowed_retrieval')
-        self.primary_key_column_nm = row_data.get('primary_key_column_nm')
         self.destination_credential_information = row_data.get('destination_credential_information')
         self.source_credential_information = row_data.get('source_credential_information')
+        self.primary_key_column_nm = row_data.get('primary_key_column_nm')
+        self.updated_date_column_nm = row_data.get('updated_date_column_nm')
+        self.sync_cursor_dsc = row_data.get('sync_cursor_dsc')
 
     def increment_stage(self):
         self.stage += 1

dc_sdk/src/pipeline.py

@@ -1,4 +1,4 @@
-import json, io, math, re
+import json, io, math, re, inspect
 import time
 from .services.environment import PipelineEnvironment
 from .services.api import DataConnectorAPI
@@ -35,6 +35,7 @@ class PipelineConductor:
         self.mapping = kwargs.get("mapping")
         self.pipeline_object_id = kwargs.get("pipeline_mapping_id")
         self.successful_keys = []
+        self.extracted_sync_cursor = None
         self.config = PipelineEnvironment
         self.api = api or DataConnectorAPI()
         self.aws = aws or AwsService(PipelineEnvironment.aws_s3_bucket)
@@ -46,7 +47,7 @@ class PipelineConductor:
         
         # get connector credentials
         Connector = load_connector()
-        self.connector = Connector(self.credentials)
+        self.connector = self._create_connector(Connector, self.credentials)
 
         self.row_count = 0
         self.log_templates = self._get_log_messages()
@@ -131,6 +132,7 @@ class PipelineConductor:
 
         while "next_page" in results and results["next_page"] != None:
             if "data" in results and results["data"] != None and results["data"] != []:
+                self._update_extracted_sync_cursor(results.get("metadata"))
                 limit_reached = self._process_rows(results["data"], max_allowed)
                 if limit_reached:
                     break
@@ -145,9 +147,15 @@ class PipelineConductor:
                 results = self.connector.get_data(self.pipeline_details.source_object_id, self._get_field_ids(), n_rows=nrows, filters=self._get_filters(), options=self.pipeline_details.options, next_page=results["next_page"])
         
         if "data" in results and results["data"] != None and results["data"] != []:
+            self._update_extracted_sync_cursor(results.get("metadata"))
             self._process_rows(results["data"], max_allowed)
         elif results["data"] != []:
             self.internal_log(self.log_templates.INTERNAL_GET_DATA_FETCHED.format(0))
+        else:
+            self._update_extracted_sync_cursor(results.get("metadata"))
+
+        if self._should_track_sync_cursor():
+            self._upload_extracted_sync_cursor()
 
         self.log(self.log_templates.GET_DATA_FINISH.format(self.row_count, self.pipeline_details.source_object_id))
 
@@ -163,7 +171,7 @@ class PipelineConductor:
 
         if not keys:
             # Call load_data with empty data when there are no keys
-            loaded = self.connector.load_data([], self.pipeline_details.destination_object_id, self._get_mapping(), self.pipeline_details.update_method_cd, 0, 1)
+            loaded = self._call_connector_load_data([], self.pipeline_details.destination_object_id, self._get_mapping(), self.pipeline_details.update_method_cd, 0, 1)
             if not loaded:
                 raise errors.LoadDataError("Loading data failed.")
         else:
@@ -177,7 +185,7 @@ class PipelineConductor:
                 
                 data = json.load(file_object)
                 self.log(self.log_templates.LOAD_DATA_LOADED.format(len(data), self.pipeline_details.destination_object_id))
-                loaded = self.connector.load_data(data, self.pipeline_details.destination_object_id, self._get_mapping(), self.pipeline_details.update_method_cd, index, len(keys))
+                loaded = self._call_connector_load_data(data, self.pipeline_details.destination_object_id, self._get_mapping(), self.pipeline_details.update_method_cd, index, len(keys))
                 if loaded:
                     self.row_count += len(data)
                     if self.mode == "prod":
@@ -189,6 +197,159 @@ class PipelineConductor:
                 else:
                     raise errors.LoadDataError("Loading data failed.")
         self.log(self.log_templates.LOAD_DATA_FINISHED.format(self.row_count, self.pipeline_details.destination_object_id))
+        self._persist_sync_cursor_after_load()
+
+    def _create_connector(self, connector_cls, credentials):
+        init_params = inspect.signature(connector_cls.__init__).parameters
+        if "pipeline_context" in init_params:
+            return connector_cls(credentials, pipeline_context=self._get_pipeline_context())
+        return connector_cls(credentials)
+
+    def _normalize_update_method(self, update_method):
+        if update_method is None:
+            return None
+        if isinstance(update_method, int):
+            return update_method
+        if isinstance(update_method, str) and update_method.isdigit():
+            return int(update_method)
+        return update_method
+
+    def _get_sync_cursor(self):
+        return getattr(self.pipeline_details, "sync_cursor_dsc", None)
+
+    def _get_pipeline_context(self):
+        if self.task != "SOURCE":
+            return None
+
+        update_method = self._normalize_update_method(
+            getattr(self.pipeline_details, "update_method_cd", None)
+        )
+
+        return {
+            "update_method": update_method,
+            "update_date_column_nm": getattr(
+                self.pipeline_details, "updated_date_column_nm", None
+            ),
+            "sync_cursor": self._get_sync_cursor(),
+        }
+
+    def _should_track_sync_cursor(self):
+        if self.task != "SOURCE":
+            return False
+
+        update_method = self._normalize_update_method(
+            getattr(self.pipeline_details, "update_method_cd", None)
+        )
+        updated_date_column_nm = getattr(
+            self.pipeline_details, "updated_date_column_nm", None
+        )
+        return update_method == 3 and updated_date_column_nm
+
+    def _update_extracted_sync_cursor(self, metadata):
+        if not self._should_track_sync_cursor() or not metadata:
+            return
+
+        sync_cursor = metadata.get("sync_cursor")
+        if sync_cursor is None:
+            return
+
+        if self.extracted_sync_cursor is None or sync_cursor > self.extracted_sync_cursor:
+            self.extracted_sync_cursor = sync_cursor
+
+    def _get_sync_cursor_key_name(self):
+        return f"transfers/e{self.pipeline_run_history_id}-sync_cursor.json"
+
+    def _upload_extracted_sync_cursor(self):
+        if self.extracted_sync_cursor is None:
+            return
+
+        payload = json.dumps({"sync_cursor": self.extracted_sync_cursor})
+        json_buffer = io.StringIO(payload)
+        key_name = self._get_sync_cursor_key_name()
+
+        if PipelineEnvironment.platform == "aws":
+            self.aws.upload_object(key_name, json_buffer=json_buffer)
+        elif PipelineEnvironment.platform == "azure":
+            key_name = f"{PipelineEnvironment.app_env}/{key_name}"
+            self.azure.upload_object(key_name, json_buffer=json_buffer)
+
+        self.internal_log(f"Uploaded sync cursor sidecar to {key_name}")
+
+    def _load_extracted_sync_cursor(self):
+        key_name = self._get_sync_cursor_key_name()
+
+        try:
+            if PipelineEnvironment.platform == "aws":
+                file_object = self.aws.download_object(key_name)
+            elif PipelineEnvironment.platform == "azure":
+                file_object = self.azure.download_object(
+                    f"{PipelineEnvironment.app_env}/{key_name}"
+                )
+            else:
+                return None
+
+            payload = json.load(file_object)
+            return payload.get("sync_cursor")
+        except Exception as e:
+            self.internal_log(f"No sync cursor sidecar found: {e}")
+            return None
+
+    def _persist_sync_cursor_after_load(self):
+        if self.task != "DESTINATION":
+            return
+
+        sync_cursor = self._load_extracted_sync_cursor()
+        if sync_cursor is None:
+            return
+
+        if self.mode == "prod":
+            self.api.save_sync_cursor(self.pipeline_id, sync_cursor)
+
+        if PipelineEnvironment.platform == "aws":
+            self.aws.delete_object(self._get_sync_cursor_key_name())
+        elif PipelineEnvironment.platform == "azure":
+            self.azure.delete_object(
+                f"{PipelineEnvironment.app_env}/{self._get_sync_cursor_key_name()}"
+            )
+
+    def _call_connector_load_data(
+        self,
+        data,
+        object_id,
+        mapping,
+        update_method,
+        batch_number,
+        total_batches
+    ):
+        options = getattr(self.pipeline_details, "options", None) or {}
+
+        # Put primary key into options for upsert/incremental loads
+        primary_key_column_nm = getattr(self.pipeline_details, "primary_key_column_nm", None)
+        if primary_key_column_nm:
+            options["primary_key_column_nm"] = primary_key_column_nm
+
+        sig = inspect.signature(self.connector.load_data)
+
+        if "options" in sig.parameters:
+            return self.connector.load_data(
+                data,
+                object_id,
+                mapping,
+                update_method,
+                batch_number,
+                total_batches,
+                options=options
+            )
+
+        return self.connector.load_data(
+            data,
+            object_id,
+            mapping,
+            update_method,
+            batch_number,
+            total_batches
+        )
+
 
     def start_next_connector(self):
         self.internal_log(self.log_templates.INTERNAL_START_NEXT_CONNECTOR.format(self.pipeline_details.destination_connector_nm, self.pipeline_details.destination_object_id))
@@ -302,13 +463,30 @@ class PipelineConductor:
         return limit_reached
 
     def _get_credentials(self):
-        encyption_txt = self.pipeline_details.source_encryption_credential_txt if self.task == "SOURCE" else self.pipeline_details.destination_encryption_credential_txt
+        is_source = self.task == "SOURCE"
 
-        if not encyption_txt:
+        encryption_txt = (
+            self.pipeline_details.source_encryption_credential_txt
+            if is_source
+            else self.pipeline_details.destination_encryption_credential_txt
+        )
+
+        if not encryption_txt:
             return None
 
-        # Set Connector Credentials
-        return self.aws.decrypt_customer_data_object(encyption_txt, self.pipeline_details.customer_metadata_uuid)
+        credential_information = (
+            self.pipeline_details.source_credential_information
+            if is_source
+            else self.pipeline_details.destination_credential_information
+        ) or {}
+
+        return self.aws.decrypt_customer_data_object(
+            encrypted_data=encryption_txt,
+            customer_id=self.pipeline_details.customer_metadata_uuid,
+            encrypted_data_key_txt=credential_information.get("encrypted_data_key_txt"),
+            encryption_iv_txt=credential_information.get("encryption_iv_txt"),
+            encryption_auth_tag_txt=credential_information.get("encryption_auth_tag_txt"),
+        )
 
     def _get_pipeline_details(self):
         return self.api.get_pipeline_details(str(self.pipeline_id), self.task, str(self.pipeline_run_history_id), pipeline_mapping_id=self.pipeline_object_id)

dc_sdk/src/services/api.py

@@ -113,6 +113,12 @@ class DataConnectorAPI:
 
         self.post(f"{pipeline_id}/mapping", body)
 
+    def save_sync_cursor(self, pipeline_id, sync_cursor):
+        self.put(
+            f"{pipeline_id}/sync-cursor",
+            {"sync_cursor_dsc": sync_cursor},
+        )
+
     def _request(self, method, endpoint, body=None, max_attempts=4):
         endpoint = endpoint.lstrip("/")
         url = f"{self.pipelines_base_url}/{endpoint}"

dc_sdk/src/services/aws.py

@@ -164,9 +164,6 @@ class AwsService:
         )
 
 
-
-
-
 class EncryptionService:
     def decrypt_customer_data(
         self,