From a1d681f19addb27b5edb39301946deff0a9caef8 Mon Sep 17 00:00:00 2001 From: Tres Seaver Date: Thu, 6 Apr 2017 08:59:31 -0400 Subject: [PATCH] Drop fossil docs refs to 'read_streaming'/'execute_streaming_sql'. Closes #3267. --- docs/spanner-session-implicit-txn-usage.rst | 40 +-------------------- docs/spanner-snapshot-usage.rst | 40 +-------------------- docs/spanner-transaction-usage.rst | 40 +-------------------- 3 files changed, 3 insertions(+), 117 deletions(-) diff --git a/docs/spanner-session-implicit-txn-usage.rst b/docs/spanner-session-implicit-txn-usage.rst index e814d2552887..cf0c06672917 100644 --- a/docs/spanner-session-implicit-txn-usage.rst +++ b/docs/spanner-session-implicit-txn-usage.rst @@ -22,28 +22,10 @@ fails if the result set is too large, for row in result.rows: print(row) - -Read Streaming Table Data -------------------------- - -Read data for selected rows from a table in the session's database. Calls -the ``StreamingRead`` API, which returns partial result sets. -:meth:`Session.streaming_read` coalesces these partial result sets as its -result object's rows are iterated. - -.. code:: python - - result = session.read_streaming( - table='table-name', columns=['first_name', 'last_name', 'age'], - key_set=VERY_LONG_LIST_OF_KEYS) - - for row in result.rows: - print(row) - .. note:: If streaming a chunk fails due to a "resumable" error, - :meth:`Session.read_streaming` retries the ``StreamingRead`` API reqeust, + :meth:`Session.read` retries the ``StreamingRead`` API reqeust, passing the ``resume_token`` from the last partial result streamed. @@ -66,26 +48,6 @@ fails if the result set is too large, print(row) -Execute a Streaming SQL Select Statement ----------------------------------------- - -Read data a query against tables in the session's database. Calls -the ``ExecuteStreamingSql`` API, which returns partial result sets. -:meth:`Session.execute_streaming_sql` coalesces these partial result sets as -its result object's rows are iterated. - -.. code:: python - - QUERY = ( - 'SELECT e.first_name, e.last_name, p.telephone ' - 'FROM employees as e, phones as p ' - 'WHERE p.employee_id == e.employee_id') - result = session.execute_streaming_sql(QUERY) - - for row in result.rows: - print(row) - - Next Step --------- diff --git a/docs/spanner-snapshot-usage.rst b/docs/spanner-snapshot-usage.rst index 888bbd027b43..272612c00e75 100644 --- a/docs/spanner-snapshot-usage.rst +++ b/docs/spanner-snapshot-usage.rst @@ -52,28 +52,10 @@ fails if the result set is too large, for row in result.rows: print(row) - -Read Streaming Table Data -------------------------- - -Read data for selected rows from a table in the session's database. Calls -the ``StreamingRead`` API, which returns partial result sets. -:meth:`Session.streaming_read` coalesces these partial result sets as its -result object's rows are iterated. - -.. code:: python - - result = snapshot.read_streaming( - table='table-name', columns=['first_name', 'last_name', 'age'], - key_set=VERY_LONG_LIST_OF_KEYS) - - for row in result.rows: - print(row) - .. note:: If streaming a chunk fails due to a "resumable" error, - :meth:`Session.read_streaming` retries the ``StreamingRead`` API reqeust, + :meth:`Session.read` retries the ``StreamingRead`` API reqeust, passing the ``resume_token`` from the last partial result streamed. @@ -96,26 +78,6 @@ fails if the result set is too large, print(row) -Execute a Streaming SQL Select Statement ----------------------------------------- - -Read data a query against tables in the session's database. Calls -the ``ExecuteStreamingSql`` API, which returns partial result sets. -:meth:`Session.execute_streaming_sql` coalesces these partial result sets as -its result object's rows are iterated. - -.. code:: python - - QUERY = ( - 'SELECT e.first_name, e.last_name, p.telephone ' - 'FROM employees as e, phones as p ' - 'WHERE p.employee_id == e.employee_id') - result = snapshot.execute_streaming_sql(QUERY) - - for row in result.rows: - print(row) - - Next Step --------- diff --git a/docs/spanner-transaction-usage.rst b/docs/spanner-transaction-usage.rst index adb8ffe320a9..0577bc2093b8 100644 --- a/docs/spanner-transaction-usage.rst +++ b/docs/spanner-transaction-usage.rst @@ -32,28 +32,10 @@ fails if the result set is too large, for row in result.rows: print(row) - -Read Streaming Table Data -------------------------- - -Read data for selected rows from a table in the session's database. Calls -the ``StreamingRead`` API, which returns partial result sets. -:meth:`Session.streaming_read` coalesces these partial result sets as its -result object's rows are iterated. - -.. code:: python - - result = transaction.read_streaming( - table='table-name', columns=['first_name', 'last_name', 'age'], - key_set=VERY_LONG_LIST_OF_KEYS) - - for row in result.rows: - print(row) - .. note:: If streaming a chunk fails due to a "resumable" error, - :meth:`Session.read_streaming` retries the ``StreamingRead`` API reqeust, + :meth:`Session.read` retries the ``StreamingRead`` API reqeust, passing the ``resume_token`` from the last partial result streamed. @@ -76,26 +58,6 @@ fails if the result set is too large, print(row) -Execute a Streaming SQL Select Statement ----------------------------------------- - -Read data a query against tables in the session's database. Calls -the ``ExecuteStreamingSql`` API, which returns partial result sets. -:meth:`Session.execute_streaming_sql` coalesces these partial result sets as -its result object's rows are iterated. - -.. code:: python - - QUERY = ( - 'SELECT e.first_name, e.last_name, p.telephone ' - 'FROM employees as e, phones as p ' - 'WHERE p.employee_id == e.employee_id') - result = transaction.execute_streaming_sql(QUERY) - - for row in result.rows: - print(row) - - Insert records using a Transaction ----------------------------------