@@ -605,11 +605,11 @@ public void deleteSession(com.google.spanner.v1.DeleteSessionRequest request,
605605
606606 /**
607607 * <pre>
608- * Executes an SQL query , returning all rows in a single reply. This
608+ * Executes an SQL statement , returning all results in a single reply. This
609609 * method cannot be used to return a result set larger than 10 MiB;
610610 * if the query yields more data than that, the query fails with
611611 * a `FAILED_PRECONDITION` error.
612- * Queries inside read-write transactions might return `ABORTED`. If
612+ * Operations inside read-write transactions might return `ABORTED`. If
613613 * this occurs, the application should restart the transaction from
614614 * the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
615615 * Larger result sets can be fetched in streaming fashion by calling
@@ -723,7 +723,9 @@ public void rollback(com.google.spanner.v1.RollbackRequest request,
723723 * must be used by the PartitionQueryRequest used to create the
724724 * partition tokens and the ExecuteSqlRequests that use the partition tokens.
725725 * Partition tokens become invalid when the session used to create them
726- * is deleted or begins a new transaction.
726+ * is deleted, is idle for too long, begins a new transaction, or becomes too
727+ * old. When any of these happen, it is not possible to resume the query, and
728+ * the whole operation must be restarted from the beginning.
727729 * </pre>
728730 */
729731 public void partitionQuery (com .google .spanner .v1 .PartitionQueryRequest request ,
@@ -738,9 +740,13 @@ public void partitionQuery(com.google.spanner.v1.PartitionQueryRequest request,
738740 * by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a subset of the read
739741 * result to read. The same session and read-only transaction must be used by
740742 * the PartitionReadRequest used to create the partition tokens and the
741- * ReadRequests that use the partition tokens.
743+ * ReadRequests that use the partition tokens. There are no ordering
744+ * guarantees on rows returned among the returned partition tokens, or even
745+ * within each individual StreamingRead call issued with a partition_token.
742746 * Partition tokens become invalid when the session used to create them
743- * is deleted or begins a new transaction.
747+ * is deleted, is idle for too long, begins a new transaction, or becomes too
748+ * old. When any of these happen, it is not possible to resume the read, and
749+ * the whole operation must be restarted from the beginning.
744750 * </pre>
745751 */
746752 public void partitionRead (com .google .spanner .v1 .PartitionReadRequest request ,
@@ -931,11 +937,11 @@ public void deleteSession(com.google.spanner.v1.DeleteSessionRequest request,
931937
932938 /**
933939 * <pre>
934- * Executes an SQL query , returning all rows in a single reply. This
940+ * Executes an SQL statement , returning all results in a single reply. This
935941 * method cannot be used to return a result set larger than 10 MiB;
936942 * if the query yields more data than that, the query fails with
937943 * a `FAILED_PRECONDITION` error.
938- * Queries inside read-write transactions might return `ABORTED`. If
944+ * Operations inside read-write transactions might return `ABORTED`. If
939945 * this occurs, the application should restart the transaction from
940946 * the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
941947 * Larger result sets can be fetched in streaming fashion by calling
@@ -1056,7 +1062,9 @@ public void rollback(com.google.spanner.v1.RollbackRequest request,
10561062 * must be used by the PartitionQueryRequest used to create the
10571063 * partition tokens and the ExecuteSqlRequests that use the partition tokens.
10581064 * Partition tokens become invalid when the session used to create them
1059- * is deleted or begins a new transaction.
1065+ * is deleted, is idle for too long, begins a new transaction, or becomes too
1066+ * old. When any of these happen, it is not possible to resume the query, and
1067+ * the whole operation must be restarted from the beginning.
10601068 * </pre>
10611069 */
10621070 public void partitionQuery (com .google .spanner .v1 .PartitionQueryRequest request ,
@@ -1072,9 +1080,13 @@ public void partitionQuery(com.google.spanner.v1.PartitionQueryRequest request,
10721080 * by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a subset of the read
10731081 * result to read. The same session and read-only transaction must be used by
10741082 * the PartitionReadRequest used to create the partition tokens and the
1075- * ReadRequests that use the partition tokens.
1083+ * ReadRequests that use the partition tokens. There are no ordering
1084+ * guarantees on rows returned among the returned partition tokens, or even
1085+ * within each individual StreamingRead call issued with a partition_token.
10761086 * Partition tokens become invalid when the session used to create them
1077- * is deleted or begins a new transaction.
1087+ * is deleted, is idle for too long, begins a new transaction, or becomes too
1088+ * old. When any of these happen, it is not possible to resume the read, and
1089+ * the whole operation must be restarted from the beginning.
10781090 * </pre>
10791091 */
10801092 public void partitionRead (com .google .spanner .v1 .PartitionReadRequest request ,
@@ -1166,11 +1178,11 @@ public com.google.protobuf.Empty deleteSession(com.google.spanner.v1.DeleteSessi
11661178
11671179 /**
11681180 * <pre>
1169- * Executes an SQL query , returning all rows in a single reply. This
1181+ * Executes an SQL statement , returning all results in a single reply. This
11701182 * method cannot be used to return a result set larger than 10 MiB;
11711183 * if the query yields more data than that, the query fails with
11721184 * a `FAILED_PRECONDITION` error.
1173- * Queries inside read-write transactions might return `ABORTED`. If
1185+ * Operations inside read-write transactions might return `ABORTED`. If
11741186 * this occurs, the application should restart the transaction from
11751187 * the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
11761188 * Larger result sets can be fetched in streaming fashion by calling
@@ -1286,7 +1298,9 @@ public com.google.protobuf.Empty rollback(com.google.spanner.v1.RollbackRequest
12861298 * must be used by the PartitionQueryRequest used to create the
12871299 * partition tokens and the ExecuteSqlRequests that use the partition tokens.
12881300 * Partition tokens become invalid when the session used to create them
1289- * is deleted or begins a new transaction.
1301+ * is deleted, is idle for too long, begins a new transaction, or becomes too
1302+ * old. When any of these happen, it is not possible to resume the query, and
1303+ * the whole operation must be restarted from the beginning.
12901304 * </pre>
12911305 */
12921306 public com .google .spanner .v1 .PartitionResponse partitionQuery (com .google .spanner .v1 .PartitionQueryRequest request ) {
@@ -1301,9 +1315,13 @@ public com.google.spanner.v1.PartitionResponse partitionQuery(com.google.spanner
13011315 * by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a subset of the read
13021316 * result to read. The same session and read-only transaction must be used by
13031317 * the PartitionReadRequest used to create the partition tokens and the
1304- * ReadRequests that use the partition tokens.
1318+ * ReadRequests that use the partition tokens. There are no ordering
1319+ * guarantees on rows returned among the returned partition tokens, or even
1320+ * within each individual StreamingRead call issued with a partition_token.
13051321 * Partition tokens become invalid when the session used to create them
1306- * is deleted or begins a new transaction.
1322+ * is deleted, is idle for too long, begins a new transaction, or becomes too
1323+ * old. When any of these happen, it is not possible to resume the read, and
1324+ * the whole operation must be restarted from the beginning.
13071325 * </pre>
13081326 */
13091327 public com .google .spanner .v1 .PartitionResponse partitionRead (com .google .spanner .v1 .PartitionReadRequest request ) {
@@ -1398,11 +1416,11 @@ public com.google.common.util.concurrent.ListenableFuture<com.google.protobuf.Em
13981416
13991417 /**
14001418 * <pre>
1401- * Executes an SQL query , returning all rows in a single reply. This
1419+ * Executes an SQL statement , returning all results in a single reply. This
14021420 * method cannot be used to return a result set larger than 10 MiB;
14031421 * if the query yields more data than that, the query fails with
14041422 * a `FAILED_PRECONDITION` error.
1405- * Queries inside read-write transactions might return `ABORTED`. If
1423+ * Operations inside read-write transactions might return `ABORTED`. If
14061424 * this occurs, the application should restart the transaction from
14071425 * the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
14081426 * Larger result sets can be fetched in streaming fashion by calling
@@ -1493,7 +1511,9 @@ public com.google.common.util.concurrent.ListenableFuture<com.google.protobuf.Em
14931511 * must be used by the PartitionQueryRequest used to create the
14941512 * partition tokens and the ExecuteSqlRequests that use the partition tokens.
14951513 * Partition tokens become invalid when the session used to create them
1496- * is deleted or begins a new transaction.
1514+ * is deleted, is idle for too long, begins a new transaction, or becomes too
1515+ * old. When any of these happen, it is not possible to resume the query, and
1516+ * the whole operation must be restarted from the beginning.
14971517 * </pre>
14981518 */
14991519 public com .google .common .util .concurrent .ListenableFuture <com .google .spanner .v1 .PartitionResponse > partitionQuery (
@@ -1509,9 +1529,13 @@ public com.google.common.util.concurrent.ListenableFuture<com.google.spanner.v1.
15091529 * by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a subset of the read
15101530 * result to read. The same session and read-only transaction must be used by
15111531 * the PartitionReadRequest used to create the partition tokens and the
1512- * ReadRequests that use the partition tokens.
1532+ * ReadRequests that use the partition tokens. There are no ordering
1533+ * guarantees on rows returned among the returned partition tokens, or even
1534+ * within each individual StreamingRead call issued with a partition_token.
15131535 * Partition tokens become invalid when the session used to create them
1514- * is deleted or begins a new transaction.
1536+ * is deleted, is idle for too long, begins a new transaction, or becomes too
1537+ * old. When any of these happen, it is not possible to resume the read, and
1538+ * the whole operation must be restarted from the beginning.
15151539 * </pre>
15161540 */
15171541 public com .google .common .util .concurrent .ListenableFuture <com .google .spanner .v1 .PartitionResponse > partitionRead (
0 commit comments