BigQuery: Document the behavior that streaming inserts are not present in destination output (#3407)

yihanzhen · web-flow · commit 1d28f12d28ca · 2018-06-27T11:29:07.000-07:00
diff --git a/google-cloud-clients/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Table.java b/google-cloud-clients/google-cloud-bigquery/src/main/java/com/google/cloud/bigquery/Table.java
@@ -235,6 +235,12 @@ public boolean delete() {
   /**
    * Insert rows into the table.
    *
+   * <p>Streaming inserts reside temporarily in the streaming buffer, which has different
+   * availability characteristics than managed storage. Certain operations do not interact with the
+   * streaming buffer, such as {@link #list(TableDataListOption...)} and {@link #copy(TableId,
+   * JobOption...)}. As such, recent streaming data will not be present in the destination table or
+   * output.
+   *
    * <p>Example of inserting rows into the table.
    * <pre> {@code
    * String rowId1 = "rowId1";
@@ -263,6 +269,12 @@ public InsertAllResponse insert(Iterable<InsertAllRequest.RowToInsert> rows)
   /**
    * Insert rows into the table.
    *
+   * <p>Streaming inserts reside temporarily in the streaming buffer, which has different
+   * availability characteristics than managed storage. Certain operations do not interact with the
+   * streaming buffer, such as {@link #list(TableDataListOption...)} and {@link #copy(TableId,
+   * JobOption...)}. As such, recent streaming data will not be present in the destination table or
+   * output.
+   *
    * <p>Example of inserting rows into the table, ignoring invalid rows.
    * <pre> {@code
    * String rowId1 = "rowId1";
