Skip to content

Commit eec1afd

Browse files
tseaverlukesneeringer
authored andcommitted
Drop fossil docs refs to 'read_streaming'/'execute_streaming_sql'. (#3276)
Closes #3267.
1 parent a9268a3 commit eec1afd

3 files changed

Lines changed: 3 additions & 117 deletions

File tree

docs/spanner-session-implicit-txn-usage.rst

Lines changed: 1 addition & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -22,28 +22,10 @@ fails if the result set is too large,
2222
for row in result.rows:
2323
print(row)
2424
25-
26-
Read Streaming Table Data
27-
-------------------------
28-
29-
Read data for selected rows from a table in the session's database. Calls
30-
the ``StreamingRead`` API, which returns partial result sets.
31-
:meth:`Session.streaming_read` coalesces these partial result sets as its
32-
result object's rows are iterated.
33-
34-
.. code:: python
35-
36-
result = session.read_streaming(
37-
table='table-name', columns=['first_name', 'last_name', 'age'],
38-
key_set=VERY_LONG_LIST_OF_KEYS)
39-
40-
for row in result.rows:
41-
print(row)
42-
4325
.. note::
4426

4527
If streaming a chunk fails due to a "resumable" error,
46-
:meth:`Session.read_streaming` retries the ``StreamingRead`` API reqeust,
28+
:meth:`Session.read` retries the ``StreamingRead`` API reqeust,
4729
passing the ``resume_token`` from the last partial result streamed.
4830

4931

@@ -66,26 +48,6 @@ fails if the result set is too large,
6648
print(row)
6749
6850
69-
Execute a Streaming SQL Select Statement
70-
----------------------------------------
71-
72-
Read data a query against tables in the session's database. Calls
73-
the ``ExecuteStreamingSql`` API, which returns partial result sets.
74-
:meth:`Session.execute_streaming_sql` coalesces these partial result sets as
75-
its result object's rows are iterated.
76-
77-
.. code:: python
78-
79-
QUERY = (
80-
'SELECT e.first_name, e.last_name, p.telephone '
81-
'FROM employees as e, phones as p '
82-
'WHERE p.employee_id == e.employee_id')
83-
result = session.execute_streaming_sql(QUERY)
84-
85-
for row in result.rows:
86-
print(row)
87-
88-
8951
Next Step
9052
---------
9153

docs/spanner-snapshot-usage.rst

Lines changed: 1 addition & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -52,28 +52,10 @@ fails if the result set is too large,
5252
for row in result.rows:
5353
print(row)
5454
55-
56-
Read Streaming Table Data
57-
-------------------------
58-
59-
Read data for selected rows from a table in the session's database. Calls
60-
the ``StreamingRead`` API, which returns partial result sets.
61-
:meth:`Session.streaming_read` coalesces these partial result sets as its
62-
result object's rows are iterated.
63-
64-
.. code:: python
65-
66-
result = snapshot.read_streaming(
67-
table='table-name', columns=['first_name', 'last_name', 'age'],
68-
key_set=VERY_LONG_LIST_OF_KEYS)
69-
70-
for row in result.rows:
71-
print(row)
72-
7355
.. note::
7456

7557
If streaming a chunk fails due to a "resumable" error,
76-
:meth:`Session.read_streaming` retries the ``StreamingRead`` API reqeust,
58+
:meth:`Session.read` retries the ``StreamingRead`` API reqeust,
7759
passing the ``resume_token`` from the last partial result streamed.
7860

7961

@@ -96,26 +78,6 @@ fails if the result set is too large,
9678
print(row)
9779
9880
99-
Execute a Streaming SQL Select Statement
100-
----------------------------------------
101-
102-
Read data a query against tables in the session's database. Calls
103-
the ``ExecuteStreamingSql`` API, which returns partial result sets.
104-
:meth:`Session.execute_streaming_sql` coalesces these partial result sets as
105-
its result object's rows are iterated.
106-
107-
.. code:: python
108-
109-
QUERY = (
110-
'SELECT e.first_name, e.last_name, p.telephone '
111-
'FROM employees as e, phones as p '
112-
'WHERE p.employee_id == e.employee_id')
113-
result = snapshot.execute_streaming_sql(QUERY)
114-
115-
for row in result.rows:
116-
print(row)
117-
118-
11981
Next Step
12082
---------
12183

docs/spanner-transaction-usage.rst

Lines changed: 1 addition & 39 deletions
Original file line numberDiff line numberDiff line change
@@ -32,28 +32,10 @@ fails if the result set is too large,
3232
for row in result.rows:
3333
print(row)
3434
35-
36-
Read Streaming Table Data
37-
-------------------------
38-
39-
Read data for selected rows from a table in the session's database. Calls
40-
the ``StreamingRead`` API, which returns partial result sets.
41-
:meth:`Session.streaming_read` coalesces these partial result sets as its
42-
result object's rows are iterated.
43-
44-
.. code:: python
45-
46-
result = transaction.read_streaming(
47-
table='table-name', columns=['first_name', 'last_name', 'age'],
48-
key_set=VERY_LONG_LIST_OF_KEYS)
49-
50-
for row in result.rows:
51-
print(row)
52-
5335
.. note::
5436

5537
If streaming a chunk fails due to a "resumable" error,
56-
:meth:`Session.read_streaming` retries the ``StreamingRead`` API reqeust,
38+
:meth:`Session.read` retries the ``StreamingRead`` API reqeust,
5739
passing the ``resume_token`` from the last partial result streamed.
5840

5941

@@ -76,26 +58,6 @@ fails if the result set is too large,
7658
print(row)
7759
7860
79-
Execute a Streaming SQL Select Statement
80-
----------------------------------------
81-
82-
Read data a query against tables in the session's database. Calls
83-
the ``ExecuteStreamingSql`` API, which returns partial result sets.
84-
:meth:`Session.execute_streaming_sql` coalesces these partial result sets as
85-
its result object's rows are iterated.
86-
87-
.. code:: python
88-
89-
QUERY = (
90-
'SELECT e.first_name, e.last_name, p.telephone '
91-
'FROM employees as e, phones as p '
92-
'WHERE p.employee_id == e.employee_id')
93-
result = transaction.execute_streaming_sql(QUERY)
94-
95-
for row in result.rows:
96-
print(row)
97-
98-
9961
Insert records using a Transaction
10062
----------------------------------
10163

0 commit comments

Comments
 (0)