overwrite_files.h

Go to the documentation of this file.

/*
 * 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.
 */
 
#pragma once
 
 
#include <cstdint>
#include <memory>
#include <optional>
#include <string>
 
#include "iceberg/iceberg_export.h"
#include "iceberg/result.h"
#include "iceberg/type_fwd.h"
#include "iceberg/update/merging_snapshot_update.h"
#include "iceberg/util/data_file_set.h"
 
namespace iceberg {
 
class ICEBERG_EXPORT OverwriteFiles : public MergingSnapshotUpdate {
 public:
  static Result<std::shared_ptr<OverwriteFiles>> Make(
      std::string table_name, std::shared_ptr<TransactionContext> ctx);
 
  ~OverwriteFiles() override;
 
  OverwriteFiles& AddFile(const std::shared_ptr<DataFile>& file);
 
  OverwriteFiles& DeleteFile(const std::shared_ptr<DataFile>& file);
 
  OverwriteFiles& DeleteFiles(const DataFileSet& data_files_to_delete,
                              const DeleteFileSet& delete_files_to_delete);
 
  OverwriteFiles& OverwriteByRowFilter(std::shared_ptr<Expression> expr);
 
  OverwriteFiles& ValidateFromSnapshot(int64_t snapshot_id);
 
  OverwriteFiles& ConflictDetectionFilter(std::shared_ptr<Expression> expr);
 
  OverwriteFiles& ValidateNoConflictingData();
 
  OverwriteFiles& ValidateNoConflictingDeletes();
 
  OverwriteFiles& ValidateAddedFilesMatchOverwriteFilter();
 
  OverwriteFiles& CaseSensitive(bool case_sensitive);
 
  std::string operation() override;
 
 protected:
  Status Validate(const TableMetadata& current_metadata,
                  const std::shared_ptr<Snapshot>& snapshot) override;
 
 private:
  explicit OverwriteFiles(std::string table_name,
                          std::shared_ptr<TransactionContext> ctx);
 
  std::shared_ptr<Expression> DataConflictDetectionFilter() const;
 
  DataFileSet deleted_data_files_;
  bool validate_added_files_match_overwrite_filter_ = false;
  std::optional<int64_t> starting_snapshot_id_;
  std::shared_ptr<Expression> conflict_detection_filter_;
  bool validate_new_data_files_ = false;
  bool validate_new_deletes_ = false;
};
 
}  // namespace iceberg