Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: mark BigQueryWrite v1beta2 as deprecated #2421

Merged
merged 2 commits into from
Feb 28, 2024
Merged

docs: mark BigQueryWrite v1beta2 as deprecated #2421

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
7364f25
docs: mark BigQueryWrite v1beta2 as deprecated
gcf-owl-bot[bot] Feb 28, 2024
fedfb92
🦉 Updates from OwlBot post-processor
gcf-owl-bot[bot] Feb 28, 2024
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
49 changes: 49 additions & 0 deletions ...ystorage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BigQueryWriteClient.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -209,8 +209,11 @@
* }</pre>
*
* <p>Please refer to the GitHub repository's samples for more quickstart code snippets.
*
* @deprecated This class is deprecated and will be removed in the next major version update.
*/
@BetaApi
@Deprecated
@Generated("by gapic-generator-java")
public class BigQueryWriteClient implements BackgroundResource {
private final BigQueryWriteSettings settings;
Expand Down Expand Up @@ -288,7 +291,9 @@ public BigQueryWriteStub getStub() {
* `projects/{project}/datasets/{dataset}/tables/{table}`.
* @param writeStream Required. Stream to be created.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final WriteStream createWriteStream(TableName parent, WriteStream writeStream) {
CreateWriteStreamRequest request =
CreateWriteStreamRequest.newBuilder()
Expand Down Expand Up @@ -325,7 +330,9 @@ public final WriteStream createWriteStream(TableName parent, WriteStream writeSt
* `projects/{project}/datasets/{dataset}/tables/{table}`.
* @param writeStream Required. Stream to be created.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final WriteStream createWriteStream(String parent, WriteStream writeStream) {
CreateWriteStreamRequest request =
CreateWriteStreamRequest.newBuilder().setParent(parent).setWriteStream(writeStream).build();
Expand Down Expand Up @@ -360,7 +367,9 @@ public final WriteStream createWriteStream(String parent, WriteStream writeStrea
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final WriteStream createWriteStream(CreateWriteStreamRequest request) {
return createWriteStreamCallable().call(request);
}
Expand Down Expand Up @@ -393,7 +402,10 @@ public final WriteStream createWriteStream(CreateWriteStreamRequest request) {
* WriteStream response = future.get();
* }
* }</pre>
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final UnaryCallable<CreateWriteStreamRequest, WriteStream> createWriteStreamCallable() {
return stub.createWriteStreamCallable();
}
Expand Down Expand Up @@ -441,7 +453,10 @@ public final UnaryCallable<CreateWriteStreamRequest, WriteStream> createWriteStr
* }
* }
* }</pre>
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final BidiStreamingCallable<AppendRowsRequest, AppendRowsResponse> appendRowsCallable() {
return stub.appendRowsCallable();
}
Expand All @@ -467,7 +482,9 @@ public final BidiStreamingCallable<AppendRowsRequest, AppendRowsResponse> append
* @param name Required. Name of the stream to get, in the form of
* `projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final WriteStream getWriteStream(WriteStreamName name) {
GetWriteStreamRequest request =
GetWriteStreamRequest.newBuilder().setName(name == null ? null : name.toString()).build();
Expand Down Expand Up @@ -495,7 +512,9 @@ public final WriteStream getWriteStream(WriteStreamName name) {
* @param name Required. Name of the stream to get, in the form of
* `projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final WriteStream getWriteStream(String name) {
GetWriteStreamRequest request = GetWriteStreamRequest.newBuilder().setName(name).build();
return getWriteStream(request);
Expand Down Expand Up @@ -525,7 +544,9 @@ public final WriteStream getWriteStream(String name) {
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final WriteStream getWriteStream(GetWriteStreamRequest request) {
return getWriteStreamCallable().call(request);
}
Expand Down Expand Up @@ -554,7 +575,10 @@ public final WriteStream getWriteStream(GetWriteStreamRequest request) {
* WriteStream response = future.get();
* }
* }</pre>
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final UnaryCallable<GetWriteStreamRequest, WriteStream> getWriteStreamCallable() {
return stub.getWriteStreamCallable();
}
Expand All @@ -581,7 +605,9 @@ public final UnaryCallable<GetWriteStreamRequest, WriteStream> getWriteStreamCal
* @param name Required. Name of the stream to finalize, in the form of
* `projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final FinalizeWriteStreamResponse finalizeWriteStream(WriteStreamName name) {
FinalizeWriteStreamRequest request =
FinalizeWriteStreamRequest.newBuilder()
Expand Down Expand Up @@ -612,7 +638,9 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(WriteStreamName nam
* @param name Required. Name of the stream to finalize, in the form of
* `projects/{project}/datasets/{dataset}/tables/{table}/streams/{stream}`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final FinalizeWriteStreamResponse finalizeWriteStream(String name) {
FinalizeWriteStreamRequest request =
FinalizeWriteStreamRequest.newBuilder().setName(name).build();
Expand Down Expand Up @@ -644,7 +672,9 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(String name) {
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final FinalizeWriteStreamResponse finalizeWriteStream(FinalizeWriteStreamRequest request) {
return finalizeWriteStreamCallable().call(request);
}
Expand Down Expand Up @@ -674,7 +704,10 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(FinalizeWriteStream
* FinalizeWriteStreamResponse response = future.get();
* }
* }</pre>
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final UnaryCallable<FinalizeWriteStreamRequest, FinalizeWriteStreamResponse>
finalizeWriteStreamCallable() {
return stub.finalizeWriteStreamCallable();
Expand Down Expand Up @@ -704,7 +737,9 @@ public final FinalizeWriteStreamResponse finalizeWriteStream(FinalizeWriteStream
* @param parent Required. Parent table that all the streams should belong to, in the form of
* `projects/{project}/datasets/{dataset}/tables/{table}`.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(String parent) {
BatchCommitWriteStreamsRequest request =
BatchCommitWriteStreamsRequest.newBuilder().setParent(parent).build();
Expand Down Expand Up @@ -738,7 +773,9 @@ public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(String pare
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(
BatchCommitWriteStreamsRequest request) {
return batchCommitWriteStreamsCallable().call(request);
Expand Down Expand Up @@ -770,7 +807,10 @@ public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(
* BatchCommitWriteStreamsResponse response = future.get();
* }
* }</pre>
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final UnaryCallable<BatchCommitWriteStreamsRequest, BatchCommitWriteStreamsResponse>
batchCommitWriteStreamsCallable() {
return stub.batchCommitWriteStreamsCallable();
Expand Down Expand Up @@ -800,7 +840,9 @@ public final BatchCommitWriteStreamsResponse batchCommitWriteStreams(
*
* @param writeStream Required. The stream that is the target of the flush operation.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final FlushRowsResponse flushRows(WriteStreamName writeStream) {
FlushRowsRequest request =
FlushRowsRequest.newBuilder()
Expand Down Expand Up @@ -833,7 +875,9 @@ public final FlushRowsResponse flushRows(WriteStreamName writeStream) {
*
* @param writeStream Required. The stream that is the target of the flush operation.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final FlushRowsResponse flushRows(String writeStream) {
FlushRowsRequest request = FlushRowsRequest.newBuilder().setWriteStream(writeStream).build();
return flushRows(request);
Expand Down Expand Up @@ -867,7 +911,9 @@ public final FlushRowsResponse flushRows(String writeStream) {
*
* @param request The request object containing all of the parameters for the API call.
* @throws com.google.api.gax.rpc.ApiException if the remote call fails
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final FlushRowsResponse flushRows(FlushRowsRequest request) {
return flushRowsCallable().call(request);
}
Expand Down Expand Up @@ -900,7 +946,10 @@ public final FlushRowsResponse flushRows(FlushRowsRequest request) {
* FlushRowsResponse response = future.get();
* }
* }</pre>
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public final UnaryCallable<FlushRowsRequest, FlushRowsResponse> flushRowsCallable() {
return stub.flushRowsCallable();
}
Expand Down
87 changes: 75 additions & 12 deletions ...torage/src/main/java/com/google/cloud/bigquery/storage/v1beta2/BigQueryWriteSettings.java
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -68,39 +68,72 @@
* .build());
* BigQueryWriteSettings bigQueryWriteSettings = bigQueryWriteSettingsBuilder.build();
* }</pre>
*
* @deprecated This class is deprecated and will be removed in the next major version update.
*/
@BetaApi
@Deprecated
@Generated("by gapic-generator-java")
public class BigQueryWriteSettings extends ClientSettings<BigQueryWriteSettings> {

/** Returns the object with the settings used for calls to createWriteStream. */
/**
* Returns the object with the settings used for calls to createWriteStream.
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public UnaryCallSettings<CreateWriteStreamRequest, WriteStream> createWriteStreamSettings() {
return ((BigQueryWriteStubSettings) getStubSettings()).createWriteStreamSettings();
}

/** Returns the object with the settings used for calls to appendRows. */
/**
* Returns the object with the settings used for calls to appendRows.
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public StreamingCallSettings<AppendRowsRequest, AppendRowsResponse> appendRowsSettings() {
return ((BigQueryWriteStubSettings) getStubSettings()).appendRowsSettings();
}

/** Returns the object with the settings used for calls to getWriteStream. */
/**
* Returns the object with the settings used for calls to getWriteStream.
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public UnaryCallSettings<GetWriteStreamRequest, WriteStream> getWriteStreamSettings() {
return ((BigQueryWriteStubSettings) getStubSettings()).getWriteStreamSettings();
}

/** Returns the object with the settings used for calls to finalizeWriteStream. */
/**
* Returns the object with the settings used for calls to finalizeWriteStream.
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public UnaryCallSettings<FinalizeWriteStreamRequest, FinalizeWriteStreamResponse>
finalizeWriteStreamSettings() {
return ((BigQueryWriteStubSettings) getStubSettings()).finalizeWriteStreamSettings();
}

/** Returns the object with the settings used for calls to batchCommitWriteStreams. */
/**
* Returns the object with the settings used for calls to batchCommitWriteStreams.
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public UnaryCallSettings<BatchCommitWriteStreamsRequest, BatchCommitWriteStreamsResponse>
batchCommitWriteStreamsSettings() {
return ((BigQueryWriteStubSettings) getStubSettings()).batchCommitWriteStreamsSettings();
}

/** Returns the object with the settings used for calls to flushRows. */
/**
* Returns the object with the settings used for calls to flushRows.
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public UnaryCallSettings<FlushRowsRequest, FlushRowsResponse> flushRowsSettings() {
return ((BigQueryWriteStubSettings) getStubSettings()).flushRowsSettings();
}
Expand Down Expand Up @@ -201,37 +234,67 @@ public Builder applyToAllUnaryMethods(
return this;
}

/** Returns the builder for the settings used for calls to createWriteStream. */
/**
* Returns the builder for the settings used for calls to createWriteStream.
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public UnaryCallSettings.Builder<CreateWriteStreamRequest, WriteStream>
createWriteStreamSettings() {
return getStubSettingsBuilder().createWriteStreamSettings();
}

/** Returns the builder for the settings used for calls to appendRows. */
/**
* Returns the builder for the settings used for calls to appendRows.
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public StreamingCallSettings.Builder<AppendRowsRequest, AppendRowsResponse>
appendRowsSettings() {
return getStubSettingsBuilder().appendRowsSettings();
}

/** Returns the builder for the settings used for calls to getWriteStream. */
/**
* Returns the builder for the settings used for calls to getWriteStream.
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public UnaryCallSettings.Builder<GetWriteStreamRequest, WriteStream> getWriteStreamSettings() {
return getStubSettingsBuilder().getWriteStreamSettings();
}

/** Returns the builder for the settings used for calls to finalizeWriteStream. */
/**
* Returns the builder for the settings used for calls to finalizeWriteStream.
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public UnaryCallSettings.Builder<FinalizeWriteStreamRequest, FinalizeWriteStreamResponse>
finalizeWriteStreamSettings() {
return getStubSettingsBuilder().finalizeWriteStreamSettings();
}

/** Returns the builder for the settings used for calls to batchCommitWriteStreams. */
/**
* Returns the builder for the settings used for calls to batchCommitWriteStreams.
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public UnaryCallSettings.Builder<
BatchCommitWriteStreamsRequest, BatchCommitWriteStreamsResponse>
batchCommitWriteStreamsSettings() {
return getStubSettingsBuilder().batchCommitWriteStreamsSettings();
}

/** Returns the builder for the settings used for calls to flushRows. */
/**
* Returns the builder for the settings used for calls to flushRows.
*
* @deprecated This method is deprecated and will be removed in the next major version update.
*/
@Deprecated
public UnaryCallSettings.Builder<FlushRowsRequest, FlushRowsResponse> flushRowsSettings() {
return getStubSettingsBuilder().flushRowsSettings();
}
Expand Down
Loading
Loading