chore(docs): update region tag and move sample and test (#1648)

* chore: added new region tags to create_table_external_data_configuration.py

* chore: delete test as part of sample migration

* chore: delete sample as part of sample migration

* chore: move sample and test to /snippets/

* chore: update import statement in create_table_external_data_configuration_test.py

* chore: fix import statement in create_table_external_data_configuration_test.py

* chore: update sample location in tables.rst

Author: meredithslota

docs/usage/tables.rst

@@ -61,7 +61,7 @@ Create an empty table with the
 Create a table using an external data source with the
 :func:`~google.cloud.bigquery.client.Client.create_table` method:
 
-.. literalinclude:: ../samples/create_table_external_data_configuration.py
+.. literalinclude:: ../samples/snippets/create_table_external_data_configuration.py
    :language: python
    :dedent: 4
    :start-after: [START bigquery_create_table_external_data_configuration]
@@ -313,4 +313,4 @@ Replace the table data with a Parquet file from Cloud Storage:
    :language: python
    :dedent: 4
    :start-after: [START bigquery_load_table_gcs_parquet_truncate]
-   :end-before: [END bigquery_load_table_gcs_parquet_truncate]
+   :end-before: [END bigquery_load_table_gcs_parquet_truncate]

samples/create_table_external_data_configuration.py renamed to samples/snippets/create_table_external_data_configuration.py

@@ -18,6 +18,7 @@ def create_table_external_data_configuration(
 ) -> None:
     """Create a table using an external data source"""
     orig_table_id = table_id
+    # [START bigquery_query_external_gcs_perm]
     # [START bigquery_create_table_external_data_configuration]
     # [START bigquery_create_external_table_definition]
     from google.cloud import bigquery
@@ -28,7 +29,9 @@ def create_table_external_data_configuration(
     # TODO(developer): Set table_id to the ID of the table to create.
     table_id = "your-project.your_dataset.your_table_name"
     # [END bigquery_create_table_external_data_configuration]
+    # [END bigquery_query_external_gcs_perm]
     table_id = orig_table_id
+    # [START bigquery_query_external_gcs_perm]
     # [START bigquery_create_table_external_data_configuration]
 
     # TODO(developer): Set the external source format of your table.
@@ -64,3 +67,4 @@ def create_table_external_data_configuration(
         f"Created table with external source format {table.external_data_configuration.source_format}"
     )
     # [END bigquery_create_table_external_data_configuration]
+    # [END bigquery_query_external_gcs_perm]

samples/tests/test_create_table_external_data_configuration.py renamed to samples/snippets/create_table_external_data_configuration_test.py

@@ -14,7 +14,7 @@
 
 import typing
 
-from .. import create_table_external_data_configuration
+import create_table_external_data_configuration
 
 if typing.TYPE_CHECKING:
     import pytest