feat: support load table with picosecond timestamp

Author: Linchin

google/cloud/bigquery/job/load.py

@@ -760,6 +760,37 @@ def column_name_character_map(self, value: Optional[str]):
         self._set_sub_prop("columnNameCharacterMap", value)
 
 
+    @property
+    def timestamp_target_precision(self) -> Optional[list[int]]:
+        """Optional[list[int]]: [Private Preview] Precisions (maximum number of
+        total digits in base 10) for seconds of TIMESTAMP types that are
+        allowed to the destination table for autodetection mode.
+
+        Available for the formats: CSV.
+
+        For the CSV Format, Possible values include:
+            None, [], or [6]: timestamp(6) for all auto detected TIMESTAMP
+            columns.
+            [6, 12]: timestamp(6) for all auto detected TIMESTAMP columns that
+            have less than 6 digits of subseconds. timestamp(12) for all auto
+            detected TIMESTAMP columns that have more than 6 digits of
+            subseconds.
+            [12]: timestamp(12) for all auto detected TIMESTAMP columns.
+        
+        The order of the elements in this array is ignored. Inputs that have
+        higher precision than the highest target precision in this array will
+        be truncated.
+        """
+        return self._get_sub_prop("timestampTargetPrecision")
+
+    @timestamp_target_precision.setter
+    def timestamp_target_precision(self, value: Optional[list[int]]):
+        if value is not None:
+            self._set_sub_prop("timestampTargetPrecision", value)
+        else:
+            self._del_sub_prop("timestampTargetPrecision")
+
+
 class LoadJob(_AsyncJob):
     """Asynchronous job for loading data into a table.
 

tests/unit/job/test_load_config.py

@@ -1061,9 +1061,33 @@ def test_column_name_character_map_none(self):
             "parquetOptions": {"enableListInference": True},
             "columnNameCharacterMap": "V2",
             "someNewField": "some-value",
+            "timestampTargetPrecision": [6, 12],
         }
     }
 
+    def test_timestamp_target_precision_missing(self):
+        config = self._get_target_class()()
+        self.assertIsNone(config.timestamp_target_precision)
+
+    def test_timestamp_target_precision_hit(self):
+        timestamp_target_precision = [6, 12]
+        config = self._get_target_class()()
+        config._properties["load"]["timestampTargetPrecision"] = timestamp_target_precision
+        self.assertEqual(config.timestamp_target_precision, timestamp_target_precision)
+
+    def test_timestamp_target_precision_setter(self):
+        timestamp_target_precision = [6, 12]
+        config = self._get_target_class()()
+        config.timestamp_target_precision = timestamp_target_precision
+        self.assertEqual(config._properties["load"]["timestampTargetPrecision"], timestamp_target_precision)
+
+    def test_timestamp_target_precision_setter_w_none(self):
+        timestamp_target_precision = [6, 12]
+        config = self._get_target_class()()
+        config._properties["load"]["timestampTargetPrecision"] = timestamp_target_precision
+        config.timestamp_target_precision = None
+        self.assertFalse("timestampTargetPrecision" in config._properties["load"])
+
     def test_from_api_repr(self):
         from google.cloud.bigquery.job import (
             CreateDisposition,
@@ -1103,6 +1127,7 @@ def test_from_api_repr(self):
         self.assertTrue(config.parquet_options.enable_list_inference)
         self.assertEqual(config.column_name_character_map, ColumnNameCharacterMap.V2)
         self.assertEqual(config._properties["load"]["someNewField"], "some-value")
+        self.assertEqual(config.timestamp_target_precision, [6, 12])
 
     def test_to_api_repr(self):
         from google.cloud.bigquery.job import (
@@ -1140,6 +1165,7 @@ def test_to_api_repr(self):
         config.parquet_options = parquet_options
         config.column_name_character_map = ColumnNameCharacterMap.V2
         config._properties["load"]["someNewField"] = "some-value"
+        config.timestamp_target_precision = [6, 12]
 
         api_repr = config.to_api_repr()