Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
42 changes: 21 additions & 21 deletions bigquery/docs/index.rst
Original file line number Diff line number Diff line change
@@ -1,10 +1,10 @@
.. include:: /../bigquery/README.rst

Using the Library
=================
-----------------

Projects
--------
~~~~~~~~

A project is the top-level container in the ``BigQuery`` API: it is tied
closely to billing, and can provide default access control across all its
Expand All @@ -23,15 +23,15 @@ To override the project inferred from the environment, pass an explicit


Project ACLs
~~~~~~~~~~~~
^^^^^^^^^^^^

Each project has an access control list granting reader / writer / owner
permission to one or more entities. This list cannot be queried or set
via the API; it must be managed using the Google Developer Console.


Datasets
--------
~~~~~~~~

A dataset represents a collection of tables, and applies several default
policies to tables as they are created:
Expand All @@ -47,7 +47,7 @@ See BigQuery documentation for more information on


Dataset operations
~~~~~~~~~~~~~~~~~~
^^^^^^^^^^^^^^^^^^

List datasets for the client's project:

Expand Down Expand Up @@ -99,13 +99,13 @@ Delete a dataset:


Tables
------
~~~~~~

Tables exist within datasets. See BigQuery documentation for more information
on `Tables <https://cloud.google.com/bigquery/docs/tables>`_.

Table operations
~~~~~~~~~~~~~~~~
^^^^^^^^^^^^^^^^
List tables for the dataset:

.. literalinclude:: snippets.py
Expand Down Expand Up @@ -187,7 +187,7 @@ Upload table data from a file:
:end-before: [END bigquery_load_from_file]

Load table data from Google Cloud Storage
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

See also: `Loading JSON data from Cloud Storage
<https://cloud.google.com/bigquery/docs/loading-data-cloud-storage-json>`_.
Expand Down Expand Up @@ -217,7 +217,7 @@ Load a Parquet file from Cloud Storage:
:end-before: [END bigquery_load_table_gcs_parquet]

Customer Managed Encryption Keys
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

Table data is always encrypted at rest, but BigQuery also provides a way for
you to control what keys it uses to encrypt they data. See `Protecting data
Expand Down Expand Up @@ -270,11 +270,11 @@ Cloud KMS for the destination table.
:end-before: [END bigquery_query_destination_table_cmek]

Queries
-------
~~~~~~~


Querying data
~~~~~~~~~~~~~
^^^^^^^^^^^^^

Run a query and wait for it to finish:

Expand All @@ -286,7 +286,7 @@ Run a query and wait for it to finish:


Run a dry run query
~~~~~~~~~~~~~~~~~~~
^^^^^^^^^^^^^^^^^^^

.. literalinclude:: snippets.py
:language: python
Expand All @@ -296,7 +296,7 @@ Run a dry run query


Writing query results to a destination table
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

See BigQuery documentation for more information on
`writing query results <https://cloud.google.com/bigquery/docs/writing-results>`_.
Expand All @@ -309,7 +309,7 @@ See BigQuery documentation for more information on


Run a query using a named query parameter
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

See BigQuery documentation for more information on
`parameterized queries <https://cloud.google.com/bigquery/docs/parameterized-queries>`_.
Expand All @@ -322,10 +322,10 @@ See BigQuery documentation for more information on


Jobs
----
~~~~

List jobs for a project
~~~~~~~~~~~~~~~~~~~~~~~
^^^^^^^^^^^^^^^^^^^^^^^

Jobs describe actions performed on data in BigQuery tables:

Expand All @@ -342,10 +342,10 @@ Jobs describe actions performed on data in BigQuery tables:


Using BigQuery with Pandas
--------------------------
~~~~~~~~~~~~~~~~~~~~~~~~~~

Retrieve BigQuery data as a Pandas DataFrame
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

As of version 0.29.0, you can use the
:func:`~google.cloud.bigquery.table.RowIterator.to_dataframe` function to
Expand Down Expand Up @@ -381,7 +381,7 @@ To retrieve table rows as a :class:`pandas.DataFrame`:
:end-before: [END bigquery_list_rows_dataframe]

Load a Pandas DataFrame to a BigQuery Table
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^

As of version 1.3.0, you can use the
:func:`~google.cloud.bigquery.client.Client.load_table_from_dataframe` function
Expand All @@ -405,7 +405,7 @@ and load it into a new table:
:end-before: [END bigquery_load_table_dataframe]

API Reference
=============
-------------

.. toctree::
:maxdepth: 2
Expand All @@ -414,7 +414,7 @@ API Reference
dbapi

Changelog
=========
---------

For a list of all ``google-cloud-bigquery`` releases:

Expand Down
2 changes: 1 addition & 1 deletion spanner/docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -23,7 +23,7 @@ API Documentation
advanced-session-pool-topics

Changelog
=========
---------

For a list of all ``google-cloud-spanner`` releases:

Expand Down