def update_dataflow_metric_tables_schemas( dataflow_metrics_dataset_id: str = DATAFLOW_METRICS_DATASET, ) -> None: """For each table that stores Dataflow metric output in the |dataflow_metrics_dataset_id|, ensures that all attributes on the corresponding metric are present in the table in BigQuery. If no |dataflow_metrics_dataset_id| is provided, defaults to the DATAFLOW_METRICS_DATASET.""" bq_client = BigQueryClientImpl() dataflow_metrics_dataset_ref = bq_client.dataset_ref_for_id( dataflow_metrics_dataset_id ) bq_client.create_dataset_if_necessary(dataflow_metrics_dataset_ref) for metric_class, table_id in DATAFLOW_METRICS_TO_TABLES.items(): schema_for_metric_class = metric_class.bq_schema_for_metric_table() if bq_client.table_exists(dataflow_metrics_dataset_ref, table_id): # Compare schema derived from metric class to existing dataflow views and update if necessary. bq_client.update_schema( dataflow_metrics_dataset_id, table_id, schema_for_metric_class ) else: # Create a table with this schema bq_client.create_table_with_schema( dataflow_metrics_dataset_id, table_id, schema_for_metric_class )
class BigQueryClientImplTest(unittest.TestCase): """Tests for BigQueryClientImpl""" def setUp(self) -> None: self.location = "US" self.mock_project_id = "fake-recidiviz-project" self.mock_dataset_id = "fake-dataset" self.mock_table_id = "test_table" self.mock_dataset_ref = bigquery.dataset.DatasetReference( self.mock_project_id, self.mock_dataset_id ) self.mock_table = self.mock_dataset_ref.table(self.mock_table_id) self.metadata_patcher = mock.patch("recidiviz.utils.metadata.project_id") self.mock_project_id_fn = self.metadata_patcher.start() self.mock_project_id_fn.return_value = self.mock_project_id self.client_patcher = mock.patch("recidiviz.big_query.big_query_client.client") self.mock_client = self.client_patcher.start().return_value self.mock_view = BigQueryView( dataset_id="dataset", view_id="test_view", view_query_template="SELECT NULL LIMIT 0", should_materialize=True, ) self.bq_client = BigQueryClientImpl() def tearDown(self) -> None: self.client_patcher.stop() self.metadata_patcher.stop() def test_create_dataset_if_necessary(self) -> None: """Check that a dataset is created if it does not exist.""" self.mock_client.get_dataset.side_effect = exceptions.NotFound("!") self.bq_client.create_dataset_if_necessary(self.mock_dataset_ref) self.mock_client.create_dataset.assert_called() def test_create_dataset_if_necessary_dataset_exists(self) -> None: """Check that a dataset is not created if it already exists.""" self.mock_client.get_dataset.side_effect = None self.bq_client.create_dataset_if_necessary(self.mock_dataset_ref) self.mock_client.create_dataset.assert_not_called() def test_create_dataset_if_necessary_table_expiration(self) -> None: """Check that the dataset is created with a set table expiration if the dataset does not exist and the new_dataset_table_expiration_ms is specified.""" self.mock_client.get_dataset.side_effect = exceptions.NotFound("!") self.bq_client.create_dataset_if_necessary( self.mock_dataset_ref, default_table_expiration_ms=6000 ) self.mock_client.create_dataset.assert_called() def test_table_exists(self) -> None: """Check that table_exists returns True if the table exists.""" self.mock_client.get_table.side_effect = None self.assertTrue( self.bq_client.table_exists(self.mock_dataset_ref, self.mock_table_id) ) def test_table_exists_does_not_exist(self) -> None: """Check that table_exists returns False if the table does not exist.""" self.mock_client.get_table.side_effect = exceptions.NotFound("!") with self.assertLogs(level="WARNING"): table_exists = self.bq_client.table_exists( self.mock_dataset_ref, self.mock_table_id ) self.assertFalse(table_exists) def test_create_or_update_view_creates_view(self) -> None: """create_or_update_view creates a View if it does not exist.""" self.mock_client.get_table.side_effect = exceptions.NotFound("!") self.bq_client.create_or_update_view(self.mock_dataset_ref, self.mock_view) self.mock_client.create_table.assert_called() self.mock_client.update_table.assert_not_called() def test_create_or_update_view_updates_view(self) -> None: """create_or_update_view updates a View if it already exist.""" self.mock_client.get_table.side_effect = None self.bq_client.create_or_update_view(self.mock_dataset_ref, self.mock_view) self.mock_client.update_table.assert_called() self.mock_client.create_table.assert_not_called() def test_export_to_cloud_storage(self) -> None: """export_to_cloud_storage extracts the table corresponding to the view.""" self.assertIsNotNone( self.bq_client.export_table_to_cloud_storage_async( source_table_dataset_ref=self.mock_dataset_ref, source_table_id="source-table", destination_uri=f"gs://{self.mock_project_id}-bucket/destination_path.json", destination_format=bigquery.DestinationFormat.NEWLINE_DELIMITED_JSON, print_header=True, ) ) self.mock_client.extract_table.assert_called() def test_export_to_cloud_storage_no_table(self) -> None: """export_to_cloud_storage does not extract from a table if the table does not exist.""" self.mock_client.get_table.side_effect = exceptions.NotFound("!") with self.assertLogs(level="WARNING"): self.assertIsNone( self.bq_client.export_table_to_cloud_storage_async( source_table_dataset_ref=self.mock_dataset_ref, source_table_id="source-table", destination_uri=f"gs://{self.mock_project_id}-bucket/destination_path.json", destination_format=bigquery.DestinationFormat.NEWLINE_DELIMITED_JSON, print_header=True, ) ) self.mock_client.extract_table.assert_not_called() def test_load_table_async_create_dataset(self) -> None: """Test that load_table_from_cloud_storage_async tries to create a parent dataset.""" self.mock_client.get_dataset.side_effect = exceptions.NotFound("!") self.bq_client.load_table_from_cloud_storage_async( destination_dataset_ref=self.mock_dataset_ref, destination_table_id=self.mock_table_id, destination_table_schema=[ SchemaField("my_column", "STRING", "NULLABLE", None, ()) ], source_uri="gs://bucket/export-uri", ) self.mock_client.create_dataset.assert_called() self.mock_client.load_table_from_uri.assert_called() def test_load_table_async_dataset_exists(self) -> None: """Test that load_table_from_cloud_storage_async does not try to create a parent dataset if it already exists.""" self.bq_client.load_table_from_cloud_storage_async( destination_dataset_ref=self.mock_dataset_ref, destination_table_id=self.mock_table_id, destination_table_schema=[ SchemaField("my_column", "STRING", "NULLABLE", None, ()) ], source_uri="gs://bucket/export-uri", ) self.mock_client.create_dataset.assert_not_called() self.mock_client.load_table_from_uri.assert_called() def test_export_query_results_to_cloud_storage_no_table(self) -> None: bucket = self.mock_project_id + "-bucket" self.mock_client.get_table.side_effect = exceptions.NotFound("!") with self.assertLogs(level="WARNING"): self.bq_client.export_query_results_to_cloud_storage( [ ExportQueryConfig.from_view_query( view=self.mock_view, view_filter_clause="WHERE x = y", intermediate_table_name=self.mock_table_id, output_uri=f"gs://{bucket}/view.json", output_format=bigquery.DestinationFormat.NEWLINE_DELIMITED_JSON, ) ], print_header=True, ) def test_export_query_results_to_cloud_storage(self) -> None: """export_query_results_to_cloud_storage creates the table from the view query and exports the table.""" bucket = self.mock_project_id + "-bucket" query_job: futures.Future = futures.Future() query_job.set_result([]) extract_job: futures.Future = futures.Future() extract_job.set_result(None) self.mock_client.query.return_value = query_job self.mock_client.extract_table.return_value = extract_job self.bq_client.export_query_results_to_cloud_storage( [ ExportQueryConfig.from_view_query( view=self.mock_view, view_filter_clause="WHERE x = y", intermediate_table_name=self.mock_table_id, output_uri=f"gs://{bucket}/view.json", output_format=bigquery.DestinationFormat.NEWLINE_DELIMITED_JSON, ) ], print_header=True, ) self.mock_client.query.assert_called() self.mock_client.extract_table.assert_called() self.mock_client.delete_table.assert_called_with( bigquery.DatasetReference( self.mock_project_id, self.mock_view.dataset_id ).table(self.mock_table_id) ) def test_create_table_from_query(self) -> None: """Tests that the create_table_from_query function calls the function to create a table from a query.""" self.bq_client.create_table_from_query_async( self.mock_dataset_id, self.mock_table_id, query="SELECT * FROM some.fake.table", query_parameters=[], ) self.mock_client.query.assert_called() @mock.patch("google.cloud.bigquery.job.QueryJobConfig") def test_insert_into_table_from_table_async( self, mock_job_config: mock.MagicMock ) -> None: """Tests that the insert_into_table_from_table_async function runs a query.""" self.bq_client.insert_into_table_from_table_async( source_dataset_id=self.mock_dataset_id, source_table_id=self.mock_table_id, destination_dataset_id=self.mock_dataset_id, destination_table_id="fake_table_temp", ) expected_query = f"SELECT * FROM `fake-recidiviz-project.{self.mock_dataset_id}.{self.mock_table_id}`" self.mock_client.get_table.assert_called() self.mock_client.query.assert_called_with( query=expected_query, location=self.location, job_config=mock_job_config() ) @mock.patch("google.cloud.bigquery.job.QueryJobConfig") def test_insert_into_table_from_table_async_hydrate_missing_columns( self, mock_job_config: mock.MagicMock ) -> None: """Tests that the insert_into_table_from_table_async generates a query with missing columns as NULL.""" with mock.patch( "recidiviz.big_query.big_query_client.BigQueryClientImpl" "._get_excess_schema_fields" ) as mock_missing: mock_missing.return_value = [ bigquery.SchemaField("state_code", "STRING", "REQUIRED"), bigquery.SchemaField("new_column_name", "INTEGER", "REQUIRED"), ] self.mock_destination_id = "fake_table_temp" self.bq_client.insert_into_table_from_table_async( source_dataset_id=self.mock_dataset_id, source_table_id=self.mock_table_id, destination_dataset_id=self.mock_dataset_id, destination_table_id=self.mock_destination_id, hydrate_missing_columns_with_null=True, allow_field_additions=True, ) expected_query = ( "SELECT *, CAST(NULL AS STRING) AS state_code, CAST(NULL AS INTEGER) AS new_column_name " f"FROM `fake-recidiviz-project.{self.mock_dataset_id}.{self.mock_table_id}`" ) self.mock_client.query.assert_called_with( query=expected_query, location=self.location, job_config=mock_job_config(), ) def test_insert_into_table_from_table_invalid_destination(self) -> None: """Tests that the insert_into_table_from_table_async function does not run the query if the destination table does not exist.""" self.mock_client.get_table.side_effect = exceptions.NotFound("!") with pytest.raises(ValueError): self.bq_client.insert_into_table_from_table_async( self.mock_dataset_id, self.mock_table_id, "fake_source_dataset_id", "fake_table_id", ) self.mock_client.get_table.assert_called() self.mock_client.query.assert_not_called() def test_insert_into_table_from_table_invalid_filter_clause(self) -> None: """Tests that the insert_into_table_from_table_async function does not run the query if the filter clause does not start with a WHERE.""" with pytest.raises(ValueError): self.bq_client.insert_into_table_from_table_async( self.mock_dataset_id, self.mock_table_id, "fake_source_dataset_id", "fake_table_id", source_data_filter_clause="bad filter clause", ) self.mock_client.query.assert_not_called() @mock.patch("google.cloud.bigquery.job.QueryJobConfig") def test_insert_into_table_from_table_with_filter_clause( self, mock_job_config: mock.MagicMock ) -> None: """Tests that the insert_into_table_from_table_async generates a valid query when given a filter clause.""" filter_clause = "WHERE state_code IN ('US_ND')" job_config = mock_job_config() self.bq_client.insert_into_table_from_table_async( self.mock_dataset_id, self.mock_table_id, "fake_source_dataset_id", "fake_table_id", source_data_filter_clause=filter_clause, ) expected_query = ( "SELECT * FROM `fake-recidiviz-project.fake-dataset.test_table` " "WHERE state_code IN ('US_ND')" ) self.mock_client.query.assert_called_with( query=expected_query, location=self.location, job_config=job_config ) def test_insert_into_table_from_cloud_storage_async(self) -> None: self.mock_client.get_dataset.side_effect = exceptions.NotFound("!") self.bq_client.insert_into_table_from_cloud_storage_async( destination_dataset_ref=self.mock_dataset_ref, destination_table_id=self.mock_table_id, destination_table_schema=[ SchemaField("my_column", "STRING", "NULLABLE", None, ()) ], source_uri="gs://bucket/export-uri", ) self.mock_client.create_dataset.assert_called() self.mock_client.load_table_from_uri.assert_called() def test_delete_from_table(self) -> None: """Tests that the delete_from_table function runs a query.""" self.bq_client.delete_from_table_async( self.mock_dataset_id, self.mock_table_id, filter_clause="WHERE x > y" ) self.mock_client.query.assert_called() def test_delete_from_table_invalid_filter_clause(self) -> None: """Tests that the delete_from_table function does not run a query when the filter clause is invalid.""" with pytest.raises(ValueError): self.bq_client.delete_from_table_async( self.mock_dataset_id, self.mock_table_id, filter_clause="x > y" ) self.mock_client.query.assert_not_called() def test_materialize_view_to_table(self) -> None: """Tests that the materialize_view_to_table function calls the function to create a table from a query.""" self.bq_client.materialize_view_to_table(self.mock_view) self.mock_client.query.assert_called() def test_materialize_view_to_table_no_materialized_view_table_id(self) -> None: """Tests that the materialize_view_to_table function does not call the function to create a table from a query if there is no set materialized_view_table_id on the view.""" invalid_view = BigQueryView( dataset_id="dataset", view_id="test_view", view_query_template="SELECT NULL LIMIT 0", should_materialize=False, ) with pytest.raises(ValueError): self.bq_client.materialize_view_to_table(invalid_view) self.mock_client.query.assert_not_called() def test_create_table_with_schema(self) -> None: """Tests that the create_table_with_schema function calls the create_table function on the client.""" self.mock_client.get_table.side_effect = exceptions.NotFound("!") schema_fields = [bigquery.SchemaField("new_schema_field", "STRING")] self.bq_client.create_table_with_schema( self.mock_dataset_id, self.mock_table_id, schema_fields ) self.mock_client.create_table.assert_called() def test_create_table_with_schema_table_exists(self) -> None: """Tests that the create_table_with_schema function raises an error when the table already exists.""" self.mock_client.get_table.side_effect = None schema_fields = [bigquery.SchemaField("new_schema_field", "STRING")] with pytest.raises(ValueError): self.bq_client.create_table_with_schema( self.mock_dataset_id, self.mock_table_id, schema_fields ) self.mock_client.create_table.assert_not_called() def test_add_missing_fields_to_schema(self) -> None: """Tests that the add_missing_fields_to_schema function calls the client to update the table.""" table_ref = bigquery.TableReference(self.mock_dataset_ref, self.mock_table_id) schema_fields = [bigquery.SchemaField("fake_schema_field", "STRING")] table = bigquery.Table(table_ref, schema_fields) self.mock_client.get_table.return_value = table new_schema_fields = [bigquery.SchemaField("new_schema_field", "STRING")] self.bq_client.add_missing_fields_to_schema( self.mock_dataset_id, self.mock_table_id, new_schema_fields ) self.mock_client.update_table.assert_called() def test_add_missing_fields_to_schema_no_missing_fields(self) -> None: """Tests that the add_missing_fields_to_schema function does not call the client to update the table when all of the fields are already present.""" table_ref = bigquery.TableReference(self.mock_dataset_ref, self.mock_table_id) schema_fields = [bigquery.SchemaField("fake_schema_field", "STRING")] table = bigquery.Table(table_ref, schema_fields) self.mock_client.get_table.return_value = table new_schema_fields = [bigquery.SchemaField("fake_schema_field", "STRING")] self.bq_client.add_missing_fields_to_schema( self.mock_dataset_id, self.mock_table_id, new_schema_fields ) self.mock_client.update_table.assert_not_called() def test_add_missing_fields_to_schema_no_table(self) -> None: """Tests that the add_missing_fields_to_schema function does not call the client to update the table when the table does not exist.""" self.mock_client.get_table.side_effect = exceptions.NotFound("!") new_schema_fields = [bigquery.SchemaField("fake_schema_field", "STRING")] with pytest.raises(ValueError): self.bq_client.add_missing_fields_to_schema( self.mock_dataset_id, self.mock_table_id, new_schema_fields ) self.mock_client.update_table.assert_not_called() def test_add_missing_fields_to_schema_fields_with_same_name_different_type( self, ) -> None: """Tests that the add_missing_fields_to_schema function raises an error when the user is trying to add a field with the same name but different field_type as an existing field.""" table_ref = bigquery.TableReference(self.mock_dataset_ref, self.mock_table_id) schema_fields = [bigquery.SchemaField("fake_schema_field", "STRING")] table = bigquery.Table(table_ref, schema_fields) self.mock_client.get_table.return_value = table new_schema_fields = [bigquery.SchemaField("fake_schema_field", "INTEGER")] with pytest.raises(ValueError): self.bq_client.add_missing_fields_to_schema( self.mock_dataset_id, self.mock_table_id, new_schema_fields ) self.mock_client.update_table.assert_not_called() def test_add_missing_fields_to_schema_fields_with_same_name_different_mode( self, ) -> None: """Tests that the add_missing_fields_to_schema function raises an error when the user is trying to add a field with the same name but different mode as an existing field.""" table_ref = bigquery.TableReference(self.mock_dataset_ref, self.mock_table_id) schema_fields = [ bigquery.SchemaField("fake_schema_field", "STRING", mode="NULLABLE") ] table = bigquery.Table(table_ref, schema_fields) self.mock_client.get_table.return_value = table new_schema_fields = [ bigquery.SchemaField("fake_schema_field", "STRING", mode="REQUIRED") ] with pytest.raises(ValueError): self.bq_client.add_missing_fields_to_schema( self.mock_dataset_id, self.mock_table_id, new_schema_fields ) self.mock_client.update_table.assert_not_called() def test_remove_unused_fields_from_schema(self) -> None: """Tests that remove_unused_fields_from_schema() calls the client to update the table with a query.""" table_ref = bigquery.TableReference(self.mock_dataset_ref, self.mock_table_id) schema_fields = [ bigquery.SchemaField("field_1", "STRING"), bigquery.SchemaField("field_2", "STRING"), ] table = bigquery.Table(table_ref, schema_fields) self.mock_client.get_table.return_value = table new_schema_fields = [bigquery.SchemaField("field_1", "STRING")] self.bq_client.remove_unused_fields_from_schema( self.mock_dataset_id, self.mock_table_id, new_schema_fields ) self.mock_client.query.assert_called() def test_remove_unused_fields_from_schema_no_missing_fields(self) -> None: """Tests that remove_unused_fields_from_schema() does nothing if there are no missing fields.""" table_ref = bigquery.TableReference(self.mock_dataset_ref, self.mock_table_id) schema_fields = [bigquery.SchemaField("field_1", "STRING")] table = bigquery.Table(table_ref, schema_fields) self.mock_client.get_table.return_value = table new_schema_fields = [bigquery.SchemaField("field_1", "STRING")] self.bq_client.remove_unused_fields_from_schema( self.mock_dataset_id, self.mock_table_id, new_schema_fields ) self.mock_client.query.assert_not_called() def test_remove_unused_fields_from_schema_ignore_excess_desired_fields( self, ) -> None: """Tests that remove_unused_fields_from_schema() drops columns even when there are excess desired fields.""" table_ref = bigquery.TableReference(self.mock_dataset_ref, self.mock_table_id) schema_fields = [ bigquery.SchemaField("field_1", "STRING"), bigquery.SchemaField("field_2", "STRING"), ] table = bigquery.Table(table_ref, schema_fields) self.mock_client.get_table.return_value = table new_schema_fields = [ bigquery.SchemaField("field_1", "STRING"), bigquery.SchemaField("field_3", "STRING"), ] self.bq_client.remove_unused_fields_from_schema( self.mock_dataset_id, self.mock_table_id, new_schema_fields ) self.mock_client.query.assert_called() @mock.patch( "recidiviz.big_query.big_query_client.BigQueryClientImpl.remove_unused_fields_from_schema" ) @mock.patch( "recidiviz.big_query.big_query_client.BigQueryClientImpl.add_missing_fields_to_schema" ) def test_update_schema( self, remove_unused_mock: mock.MagicMock, add_missing_mock: mock.MagicMock ) -> None: """Tests that update_schema() calls both field updaters if the inputs are valid.""" table_ref = bigquery.TableReference(self.mock_dataset_ref, self.mock_table_id) schema_fields = [ bigquery.SchemaField("field_1", "STRING"), bigquery.SchemaField("field_2", "STRING"), ] table = bigquery.Table(table_ref, schema_fields) self.mock_client.get_table.return_value = table new_schema_fields = [ bigquery.SchemaField("field_1", "STRING"), bigquery.SchemaField("field_3", "STRING"), ] self.bq_client.update_schema( self.mock_dataset_id, self.mock_table_id, new_schema_fields ) remove_unused_mock.assert_called() add_missing_mock.assert_called() @mock.patch( "recidiviz.big_query.big_query_client.BigQueryClientImpl.remove_unused_fields_from_schema" ) @mock.patch( "recidiviz.big_query.big_query_client.BigQueryClientImpl.add_missing_fields_to_schema" ) def test_update_schema_fails_on_changed_type( self, remove_unused_mock: mock.MagicMock, add_missing_mock: mock.MagicMock ) -> None: """Tests that update_schema() throws if we try to change a field type.""" table_ref = bigquery.TableReference(self.mock_dataset_ref, self.mock_table_id) schema_fields = [ bigquery.SchemaField("field_1", "STRING"), bigquery.SchemaField("field_2", "STRING"), ] table = bigquery.Table(table_ref, schema_fields) self.mock_client.get_table.return_value = table new_schema_fields = [ bigquery.SchemaField("field_1", "STRING"), bigquery.SchemaField("field_2", "INT"), ] with pytest.raises(ValueError): self.bq_client.update_schema( self.mock_dataset_id, self.mock_table_id, new_schema_fields ) remove_unused_mock.assert_not_called() add_missing_mock.assert_not_called() @mock.patch( "recidiviz.big_query.big_query_client.BigQueryClientImpl.remove_unused_fields_from_schema" ) @mock.patch( "recidiviz.big_query.big_query_client.BigQueryClientImpl.add_missing_fields_to_schema" ) def test_update_schema_fails_on_changed_mode( self, remove_unused_mock: mock.MagicMock, add_missing_mock: mock.MagicMock ) -> None: """Tests that update_schema() throws if we try to change a field mode.""" table_ref = bigquery.TableReference(self.mock_dataset_ref, self.mock_table_id) schema_fields = [ bigquery.SchemaField("field_1", "STRING", "NULLABLE"), bigquery.SchemaField("field_2", "STRING"), ] table = bigquery.Table(table_ref, schema_fields) self.mock_client.get_table.return_value = table new_schema_fields = [ bigquery.SchemaField("field_1", "STRING", "REQUIRED"), bigquery.SchemaField("field_2", "INT"), ] with pytest.raises(ValueError): self.bq_client.update_schema( self.mock_dataset_id, self.mock_table_id, new_schema_fields ) remove_unused_mock.assert_not_called() add_missing_mock.assert_not_called() def test__get_excess_schema_fields_simple_excess(self) -> None: """Tests _get_excess_schema_fields() when extended_schema is a strict superset of base_schema.""" base_schema = [bigquery.SchemaField("field_1", "INT")] extended_schema = [ bigquery.SchemaField("field_1", "INT"), bigquery.SchemaField("field_2", "INT"), bigquery.SchemaField("field_3", "INT"), ] excess_fields = BigQueryClientImpl._get_excess_schema_fields( base_schema, extended_schema ) self.assertEqual( excess_fields, [ bigquery.SchemaField("field_2", "INT"), bigquery.SchemaField("field_3", "INT"), ], ) def test__get_excess_schema_fields_with_extra_base_schema(self) -> None: """Tests _get_excess_schema_fields() when base_schema has fields not in extended_schema.""" base_schema = [ bigquery.SchemaField("field_1", "INT"), bigquery.SchemaField("field_2", "INT"), ] extended_schema = [ bigquery.SchemaField("field_1", "INT"), bigquery.SchemaField("field_3", "INT"), bigquery.SchemaField("field_4", "INT"), ] excess_fields = BigQueryClientImpl._get_excess_schema_fields( base_schema, extended_schema ) self.assertEqual( excess_fields, [ bigquery.SchemaField("field_3", "INT"), bigquery.SchemaField("field_4", "INT"), ], ) def test__get_excess_schema_fields_with_matching_schema(self) -> None: """Tests _get_excess_schema_fields() when base_schema is the same as extended_schema.""" base_schema = [ bigquery.SchemaField("field_1", "INT"), bigquery.SchemaField("field_2", "INT"), ] excess_fields = BigQueryClientImpl._get_excess_schema_fields( base_schema, base_schema ) self.assertListEqual(excess_fields, []) def test__get_excess_schema_fields_no_excess(self) -> None: """Tests _get_excess_schema_fields() when base_schema is a superset of extended_schema.""" base_schema = [ bigquery.SchemaField("field_1", "INT"), bigquery.SchemaField("field_2", "INT"), ] extended_schema = [bigquery.SchemaField("field_2", "INT")] excess_fields = BigQueryClientImpl._get_excess_schema_fields( base_schema, extended_schema ) self.assertListEqual(excess_fields, []) def test_delete_table(self) -> None: """Tests that our delete table function calls the correct client method.""" self.bq_client.delete_table(self.mock_dataset_id, self.mock_table_id) self.mock_client.delete_table.assert_called() @mock.patch("google.cloud.bigquery.QueryJob") def test_paged_read_single_page_single_row( self, mock_query_job: mock.MagicMock ) -> None: first_row = bigquery.table.Row( ["parole", 15, "10N"], {"supervision_type": 0, "revocations": 1, "district": 2}, ) # First call returns a single row, second call returns nothing mock_query_job.result.side_effect = [[first_row], []] processed_results = [] def _process_fn(row: bigquery.table.Row) -> None: processed_results.append(dict(row)) self.bq_client.paged_read_and_process(mock_query_job, 1, _process_fn) self.assertEqual([dict(first_row)], processed_results) mock_query_job.result.assert_has_calls( [ call(max_results=1, start_index=0), call(max_results=1, start_index=1), ] ) @mock.patch("google.cloud.bigquery.QueryJob") def test_paged_read_single_page_multiple_rows( self, mock_query_job: mock.MagicMock ) -> None: first_row = bigquery.table.Row( ["parole", 15, "10N"], {"supervision_type": 0, "revocations": 1, "district": 2}, ) second_row = bigquery.table.Row( ["probation", 7, "10N"], {"supervision_type": 0, "revocations": 1, "district": 2}, ) # First call returns a single row, second call returns nothing mock_query_job.result.side_effect = [[first_row, second_row], []] processed_results = [] def _process_fn(row: bigquery.table.Row) -> None: processed_results.append(dict(row)) self.bq_client.paged_read_and_process(mock_query_job, 10, _process_fn) self.assertEqual([dict(first_row), dict(second_row)], processed_results) mock_query_job.result.assert_has_calls( [ call(max_results=10, start_index=0), call(max_results=10, start_index=2), ] ) @mock.patch("google.cloud.bigquery.QueryJob") def test_paged_read_multiple_pages(self, mock_query_job: mock.MagicMock) -> None: p1_r1 = bigquery.table.Row( ["parole", 15, "10N"], {"supervision_type": 0, "revocations": 1, "district": 2}, ) p1_r2 = bigquery.table.Row( ["probation", 7, "10N"], {"supervision_type": 0, "revocations": 1, "district": 2}, ) p2_r1 = bigquery.table.Row( ["parole", 8, "10F"], {"supervision_type": 0, "revocations": 1, "district": 2}, ) p2_r2 = bigquery.table.Row( ["probation", 3, "10F"], {"supervision_type": 0, "revocations": 1, "district": 2}, ) # First two calls returns results, third call returns nothing mock_query_job.result.side_effect = [[p1_r1, p1_r2], [p2_r1, p2_r2], []] processed_results = [] def _process_fn(row: bigquery.table.Row) -> None: processed_results.append(dict(row)) self.bq_client.paged_read_and_process(mock_query_job, 2, _process_fn) self.assertEqual( [dict(p1_r1), dict(p1_r2), dict(p2_r1), dict(p2_r2)], processed_results ) mock_query_job.result.assert_has_calls( [ call(max_results=2, start_index=0), call(max_results=2, start_index=2), call(max_results=2, start_index=4), ] )