Skip to content

Commit 1ec41b1

Browse files
max-sixtytswast
authored andcommitted
remove old docs (#233)
1 parent 3b865c6 commit 1ec41b1

File tree

4 files changed

+2
-29
lines changed

4 files changed

+2
-29
lines changed

docs/source/intro.rst

-17
Original file line numberDiff line numberDiff line change
@@ -9,23 +9,6 @@ Pandas supports all these `BigQuery data types <https://cloud.google.com/bigquer
99
``TIMESTAMP`` (microsecond precision). Data types ``BYTES`` and ``RECORD``
1010
are not supported.
1111

12-
Integer and boolean ``NA`` handling
13-
+++++++++++++++++++++++++++++++++++
14-
15-
Since all columns in BigQuery queries are nullable, and NumPy lacks of ``NA``
16-
support for integer and boolean types, this module will store ``INTEGER`` or
17-
``BOOLEAN`` columns with at least one ``NULL`` value as ``dtype=object``.
18-
Otherwise those columns will be stored as ``dtype=int64`` or ``dtype=bool``
19-
respectively.
20-
21-
This is opposite to default pandas behaviour which will promote integer
22-
type to float in order to store NAs.
23-
`See here for how this works in pandas <https://pandas.pydata.org/pandas-docs/stable/gotchas.html#nan-integer-na-values-and-na-type-promotions>`__
24-
25-
While this trade-off works well for most cases, it breaks down for storing
26-
values greater than 2**53. Such values in BigQuery can represent identifiers
27-
and unnoticed precision lost for identifier is what we want to avoid.
28-
2912
Logging
3013
+++++++
3114

docs/source/reading.rst

+2-1
Original file line numberDiff line numberDiff line change
@@ -50,6 +50,7 @@ your job. For more information about query configuration parameters see `here
5050
.. note::
5151

5252
The ``dialect`` argument can be used to indicate whether to use BigQuery's ``'legacy'`` SQL
53-
or BigQuery's ``'standard'`` SQL (beta). The default value is ``'legacy'``. For more information
53+
or BigQuery's ``'standard'`` SQL (beta). The default value is ``'legacy'``, though this will change
54+
in a subsequent release to ``'standard'``. For more information
5455
on BigQuery's standard SQL, see `BigQuery SQL Reference
5556
<https://cloud.google.com/bigquery/sql-reference/>`__

docs/source/tables.rst

-6
Original file line numberDiff line numberDiff line change
@@ -14,9 +14,3 @@ Creating Tables
1414
{'name': 'my_int64', 'type': 'INTEGER'},
1515
{'name': 'my_string', 'type': 'STRING'}]}
1616
17-
.. note::
18-
19-
If you delete and re-create a BigQuery table with the same name, but different table schema,
20-
you must wait 2 minutes before streaming data into the table. As a workaround, consider creating
21-
the new table with a different name. Refer to
22-
`Google BigQuery issue 191 <https://code.google.com/p/google-bigquery/issues/detail?id=191>`__.

docs/source/writing.rst

-5
Original file line numberDiff line numberDiff line change
@@ -49,11 +49,6 @@ a ``TableCreationError`` if the destination table already exists.
4949
If an error occurs while streaming data to BigQuery, see
5050
`Troubleshooting BigQuery Errors <https://cloud.google.com/bigquery/troubleshooting-errors>`__.
5151

52-
.. note::
53-
54-
The BigQuery SQL query language has some oddities, see the
55-
`BigQuery Query Reference Documentation <https://cloud.google.com/bigquery/query-reference>`__.
56-
5752
.. note::
5853

5954
While BigQuery uses SQL-like syntax, it has some important differences

0 commit comments

Comments
 (0)