andresbeckruiz commented on code in PR #339: URL: https://github.com/apache/cassandra-sidecar/pull/339#discussion_r3250500100
########## server/src/main/java/org/apache/cassandra/sidecar/db/schema/ClusterOpsNodeStateSchema.java: ########## @@ -0,0 +1,129 @@ +/* + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you 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 org.apache.cassandra.sidecar.db.schema; + +import com.datastax.driver.core.PreparedStatement; +import com.datastax.driver.core.Session; +import org.apache.cassandra.sidecar.common.server.utils.SecondBoundConfiguration; +import org.apache.cassandra.sidecar.config.SchemaKeyspaceConfiguration; +import org.jetbrains.annotations.NotNull; + +/** + * Schema for the {@code cluster_ops_node_state} table, which tracks the status of an operation for a given node. + * Sidecar instances query this table to check the status of nodes being operated on before their local nodes, + * enabling distributed coordination of cluster-wide operations. + */ +public class ClusterOpsNodeStateSchema extends TableSchema +{ + private static final String TABLE_NAME = "cluster_ops_node_state"; + + private final SchemaKeyspaceConfiguration keyspaceConfig; + private final SecondBoundConfiguration tableTtl; + + private PreparedStatement insertNodeStatus; + private PreparedStatement selectNodeStatus; + private PreparedStatement selectAllNodeStatuses; + + public ClusterOpsNodeStateSchema(SchemaKeyspaceConfiguration keyspaceConfig, SecondBoundConfiguration tableTtl) + { + this.keyspaceConfig = keyspaceConfig; + this.tableTtl = tableTtl; + } + + @Override + protected String keyspaceName() + { + return keyspaceConfig.keyspace(); + } + + @Override + protected String tableName() + { + return TABLE_NAME; + } + + @Override + protected String createSchemaStatement() + { + return String.format("CREATE TABLE IF NOT EXISTS %s.%s (" + + " cluster_name text," + + " operation_id uuid," + Review Comment: Changed to `timeuuid` for consistency ########## server/src/main/java/org/apache/cassandra/sidecar/db/schema/ActiveClusterOpsSchema.java: ########## @@ -0,0 +1,137 @@ +/* + * Licensed to the Apache Software Foundation (ASF) under one + * or more contributor license agreements. See the NOTICE file + * distributed with this work for additional information + * regarding copyright ownership. The ASF licenses this file + * to you 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 org.apache.cassandra.sidecar.db.schema; + +import com.datastax.driver.core.PreparedStatement; +import com.datastax.driver.core.Session; +import org.apache.cassandra.sidecar.common.server.utils.SecondBoundConfiguration; +import org.apache.cassandra.sidecar.config.SchemaKeyspaceConfiguration; +import org.jetbrains.annotations.NotNull; + +/** + * Schema for the {@code active_cluster_ops} table, which ensures that only one active operation of a given type + * is running at a time across the cluster. When a Sidecar instance receives a request to set an operation to + * {@code RUNNING}, it inserts the operation into this table using a lightweight transaction (LWT) to guarantee + * mutual exclusion. Sidecar instances also periodically query this table to discover when an operation has been + * activated. + */ +public class ActiveClusterOpsSchema extends TableSchema +{ + private static final String TABLE_NAME = "active_cluster_ops"; + + private final SchemaKeyspaceConfiguration keyspaceConfig; + private final SecondBoundConfiguration tableTtl; + + private PreparedStatement trySetActive; + private PreparedStatement getActive; + private PreparedStatement getActiveByType; + private PreparedStatement clearActive; + + public ActiveClusterOpsSchema(SchemaKeyspaceConfiguration keyspaceConfig, SecondBoundConfiguration tableTtl) + { + this.keyspaceConfig = keyspaceConfig; + this.tableTtl = tableTtl; + } + + @Override + protected String keyspaceName() + { + return keyspaceConfig.keyspace(); + } + + @Override + protected String tableName() + { + return TABLE_NAME; + } + + @Override + protected String createSchemaStatement() + { + return String.format("CREATE TABLE IF NOT EXISTS %s.%s (" + + " cluster_name text," + + " operation_type text," + + " operation_id uuid," + Review Comment: Changed to `timeuuid` for consistency -- This is an automated message from the Apache Git Service. To respond to the message, please log on to GitHub and use the URL above to go to the specific comment. To unsubscribe, e-mail: [email protected] For queries about this service, please contact Infrastructure at: [email protected] --------------------------------------------------------------------- To unsubscribe, e-mail: [email protected] For additional commands, e-mail: [email protected]

