René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Document how to construct external tables","articleBody":" **Is your feature request related to a problem? Please describe.**\r\n\r\nCurrently, the document on creating a table is clear on how to initialize a Table object with a specific fields schema. For example, here is a code snippet from the docs:\r\n\r\n![image](https://user-images.githubusercontent.com/2574498/125806269-c756b636-22de-4353-b0f4-ebdfe9b7214a.png)\r\n\r\nHowever, a challenge I faced with these docs is knowing how to create a Table with, e.g., an ExternalConfig set.\r\n\r\nBased on the source for Table / unit tests, is the correct approach using a property setter?:\r\n\r\n```python\r\nfrom google.cloud import bigquery\r\nclient bigquery.Client()\r\n\r\ntable = bigquery.Table(...)\r\n\r\n# use property setter\r\ntable.external_data_configuration = bigquery.ExternalConfig(...)\r\n\r\n# edit: it looks like ExternalConfig also needs to use setters, so might include, e.g..\r\nexternal_config = bigquery.ExternalConfig(\"NEWLINE_DELIMITED_JSON\")\r\nexternal_config.source_uris = [...]\r\n```\r\n\r\n\r\n **Describe the solution you'd like**\r\n\r\nCan we add an example to the docs so that readers learn these two pieces?:\r\n\r\n* Table attributes like schema can be set on `__init__` (or via setters)\r\n* Other Table attributes must be set using setters\r\n\r\nIt seems like two places users may look for this info is in the Table API doc, and in the [usage/tables - creating a table](https://googleapis.dev/python/bigquery/latest/usage/tables.html#creating-a-table) doc. Also, apologies if it's already somewhere in the docs and I missed it 😅.\r\n\r\n **Describe alternatives you've considered**\r\n\r\nSince Table can be constructed using `.from_api_repr()`, I wondered if this is a more common approach for construction? In that case it seems like having a nudge in the docs on using this path for e.g. constructing an external table would be super helpful!","author":{"url":"https://github.com/machow","@type":"Person","name":"machow"},"datePublished":"2021-07-15T14:36:17.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":8},"url":"https://github.com/773/python-bigquery/issues/773"}