@@ -605,11 +605,11 @@ public void deleteSession(com.google.spanner.v1.DeleteSessionRequest request,
605
605
606
606
/**
607
607
* <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
609
609
* method cannot be used to return a result set larger than 10 MiB;
610
610
* if the query yields more data than that, the query fails with
611
611
* a `FAILED_PRECONDITION` error.
612
- * Queries inside read-write transactions might return `ABORTED`. If
612
+ * Operations inside read-write transactions might return `ABORTED`. If
613
613
* this occurs, the application should restart the transaction from
614
614
* the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
615
615
* Larger result sets can be fetched in streaming fashion by calling
@@ -723,7 +723,9 @@ public void rollback(com.google.spanner.v1.RollbackRequest request,
723
723
* must be used by the PartitionQueryRequest used to create the
724
724
* partition tokens and the ExecuteSqlRequests that use the partition tokens.
725
725
* 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.
727
729
* </pre>
728
730
*/
729
731
public void partitionQuery (com .google .spanner .v1 .PartitionQueryRequest request ,
@@ -738,9 +740,13 @@ public void partitionQuery(com.google.spanner.v1.PartitionQueryRequest request,
738
740
* by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a subset of the read
739
741
* result to read. The same session and read-only transaction must be used by
740
742
* 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.
742
746
* 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.
744
750
* </pre>
745
751
*/
746
752
public void partitionRead (com .google .spanner .v1 .PartitionReadRequest request ,
@@ -931,11 +937,11 @@ public void deleteSession(com.google.spanner.v1.DeleteSessionRequest request,
931
937
932
938
/**
933
939
* <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
935
941
* method cannot be used to return a result set larger than 10 MiB;
936
942
* if the query yields more data than that, the query fails with
937
943
* a `FAILED_PRECONDITION` error.
938
- * Queries inside read-write transactions might return `ABORTED`. If
944
+ * Operations inside read-write transactions might return `ABORTED`. If
939
945
* this occurs, the application should restart the transaction from
940
946
* the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
941
947
* Larger result sets can be fetched in streaming fashion by calling
@@ -1056,7 +1062,9 @@ public void rollback(com.google.spanner.v1.RollbackRequest request,
1056
1062
* must be used by the PartitionQueryRequest used to create the
1057
1063
* partition tokens and the ExecuteSqlRequests that use the partition tokens.
1058
1064
* 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.
1060
1068
* </pre>
1061
1069
*/
1062
1070
public void partitionQuery (com .google .spanner .v1 .PartitionQueryRequest request ,
@@ -1072,9 +1080,13 @@ public void partitionQuery(com.google.spanner.v1.PartitionQueryRequest request,
1072
1080
* by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a subset of the read
1073
1081
* result to read. The same session and read-only transaction must be used by
1074
1082
* 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.
1076
1086
* 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.
1078
1090
* </pre>
1079
1091
*/
1080
1092
public void partitionRead (com .google .spanner .v1 .PartitionReadRequest request ,
@@ -1166,11 +1178,11 @@ public com.google.protobuf.Empty deleteSession(com.google.spanner.v1.DeleteSessi
1166
1178
1167
1179
/**
1168
1180
* <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
1170
1182
* method cannot be used to return a result set larger than 10 MiB;
1171
1183
* if the query yields more data than that, the query fails with
1172
1184
* a `FAILED_PRECONDITION` error.
1173
- * Queries inside read-write transactions might return `ABORTED`. If
1185
+ * Operations inside read-write transactions might return `ABORTED`. If
1174
1186
* this occurs, the application should restart the transaction from
1175
1187
* the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
1176
1188
* 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
1286
1298
* must be used by the PartitionQueryRequest used to create the
1287
1299
* partition tokens and the ExecuteSqlRequests that use the partition tokens.
1288
1300
* 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.
1290
1304
* </pre>
1291
1305
*/
1292
1306
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
1301
1315
* by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a subset of the read
1302
1316
* result to read. The same session and read-only transaction must be used by
1303
1317
* 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.
1305
1321
* 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.
1307
1325
* </pre>
1308
1326
*/
1309
1327
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
1398
1416
1399
1417
/**
1400
1418
* <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
1402
1420
* method cannot be used to return a result set larger than 10 MiB;
1403
1421
* if the query yields more data than that, the query fails with
1404
1422
* a `FAILED_PRECONDITION` error.
1405
- * Queries inside read-write transactions might return `ABORTED`. If
1423
+ * Operations inside read-write transactions might return `ABORTED`. If
1406
1424
* this occurs, the application should restart the transaction from
1407
1425
* the beginning. See [Transaction][google.spanner.v1.Transaction] for more details.
1408
1426
* 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
1493
1511
* must be used by the PartitionQueryRequest used to create the
1494
1512
* partition tokens and the ExecuteSqlRequests that use the partition tokens.
1495
1513
* 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.
1497
1517
* </pre>
1498
1518
*/
1499
1519
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.
1509
1529
* by [StreamingRead][google.spanner.v1.Spanner.StreamingRead] to specify a subset of the read
1510
1530
* result to read. The same session and read-only transaction must be used by
1511
1531
* 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.
1513
1535
* 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.
1515
1539
* </pre>
1516
1540
*/
1517
1541
public com .google .common .util .concurrent .ListenableFuture <com .google .spanner .v1 .PartitionResponse > partitionRead (
0 commit comments