
com.google.cloud.spanner.pgadapter.statements.ReleaseStatement Maven / Gradle / Ivy
Go to download
Show more of this group Show more artifacts with this name
Show all versions of google-cloud-spanner-pgadapter Show documentation
Show all versions of google-cloud-spanner-pgadapter Show documentation
The PGAdapter server implements the PostgreSQL wire-protocol, but sends all received statements
to a Cloud Spanner database instead of a PostgreSQL database. The Cloud Spanner database must
have been created to use the PostgreSQL dialect. See https://cloud.google.com/spanner/docs/quickstart-console#postgresql
for more information on how to create PostgreSQL dialect databases on Cloud Spanner.
The newest version!
// Copyright 2023 Google LLC
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
package com.google.cloud.spanner.pgadapter.statements;
import static com.google.cloud.spanner.pgadapter.statements.SimpleParser.unquoteOrFoldIdentifier;
import com.google.cloud.spanner.Statement;
import com.google.cloud.spanner.connection.AbstractStatementParser.ParsedStatement;
import com.google.cloud.spanner.connection.AbstractStatementParser.StatementType;
import com.google.cloud.spanner.connection.StatementResult;
import com.google.cloud.spanner.pgadapter.ConnectionHandler;
import com.google.cloud.spanner.pgadapter.error.PGExceptionFactory;
import com.google.cloud.spanner.pgadapter.error.SQLState;
import com.google.cloud.spanner.pgadapter.metadata.OptionsMetadata;
import com.google.cloud.spanner.pgadapter.statements.SimpleParser.TableOrIndexName;
import com.google.common.base.Preconditions;
import com.google.common.collect.ImmutableList;
import com.google.common.util.concurrent.Futures;
import java.util.List;
import java.util.concurrent.Future;
public class ReleaseStatement extends IntermediatePortalStatement {
static class ParsedReleaseStatement {
final String name;
ParsedReleaseStatement(String name) {
this.name = name;
}
}
private final ParsedReleaseStatement parsedReleaseStatement;
public ReleaseStatement(
ConnectionHandler connectionHandler,
OptionsMetadata options,
String name,
ParsedStatement parsedStatement,
Statement originalStatement) {
super(
name,
new IntermediatePreparedStatement(
connectionHandler,
options,
name,
NO_PARAMETER_TYPES,
parsedStatement,
originalStatement),
NO_PARAMS,
ImmutableList.of(),
ImmutableList.of());
this.parsedReleaseStatement = parse(originalStatement.getSql());
}
static ParsedReleaseStatement parse(String sql) {
Preconditions.checkNotNull(sql);
// https://www.postgresql.org/docs/current/sql-release-savepoint.html
// RELEASE [ SAVEPOINT ] savepoint_name
SimpleParser parser = new SimpleParser(sql);
if (!parser.eatKeyword("release")) {
throw PGExceptionFactory.newPGException("not a valid RELEASE statement: " + sql);
}
parser.eatKeyword("savepoint");
TableOrIndexName name = parser.readTableOrIndexName();
if (name == null || name.schema != null) {
throw PGExceptionFactory.newPGException("invalid savepoint name", SQLState.SyntaxError);
}
String savepointName = unquoteOrFoldIdentifier(name.name);
parser.throwIfHasMoreTokens();
return new ParsedReleaseStatement(savepointName);
}
public String getSavepointName() {
return parsedReleaseStatement.name;
}
@Override
public String getCommandTag() {
return "RELEASE";
}
@Override
public StatementType getStatementType() {
return StatementType.CLIENT_SIDE;
}
@Override
public void executeAsync(BackendConnection backendConnection) {
this.executed = true;
setFutureStatementResult(backendConnection.execute(this));
}
@Override
public Future describeAsync(BackendConnection backendConnection) {
// Return null to indicate that this RELEASE statement does not return any
// RowDescriptionResponse.
return Futures.immediateFuture(null);
}
@Override
public IntermediatePortalStatement createPortal(
String name,
byte[][] parameters,
List parameterFormatCodes,
List resultFormatCodes) {
// RELEASE does not support binding any parameters, so we just return the same statement.
return this;
}
}
© 2015 - 2025 Weber Informatics LLC | Privacy Policy