SharedDictionaryValidator.h File Reference

#include <vector>
#include "../Catalog/ColumnDescriptor.h"
#include "../Parser/ParserNode.h"

Include dependency graph for SharedDictionaryValidator.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Functions
void	validate_shared_dictionary (const Parser::CreateTableBaseStmt *stmt, const Parser::SharedDictionaryDef *shared_dict_def, const std::list< ColumnDescriptor > &columns, const std::vector< Parser::SharedDictionaryDef > &shared_dict_defs_so_far, const Catalog_Namespace::Catalog &catalog)
const Parser::SharedDictionaryDef	compress_reference_path (Parser::SharedDictionaryDef cur_node, const std::vector< Parser::SharedDictionaryDef > &shared_dict_defs)
void	validate_shared_dictionary_order (const Parser::CreateTableBaseStmt *stmt, const Parser::SharedDictionaryDef *shared_dict_def, const std::vector< Parser::SharedDictionaryDef > &shared_dict_defs, const std::list< ColumnDescriptor > &columns)

Function Documentation

const Parser::SharedDictionaryDef compress_reference_path	(	Parser::SharedDictionaryDef	cur_node,
		const std::vector< Parser::SharedDictionaryDef > &	shared_dict_defs
	)

Definition at line 23 of file SharedDictionaryValidator.cpp.

References CHECK_LT, Parser::SharedDictionaryDef::get_column(), Parser::SharedDictionaryDef::get_foreign_column(), and Parser::SharedDictionaryDef::get_foreign_table().

Referenced by Catalog_Namespace::Catalog::setColumnSharedDictionary().

                                                                  {
  size_t idx = 0;
  for (; idx < shared_dict_defs.size(); idx++) {
    if (!shared_dict_defs[idx].get_column().compare(cur_node.get_column()) &&
        !shared_dict_defs[idx].get_foreign_table().compare(
            cur_node.get_foreign_table()) &&
        !shared_dict_defs[idx].get_foreign_column().compare(
            cur_node.get_foreign_column())) {
      break;
    }
  }
  // Make sure we have found the shared dictionary definition
  CHECK_LT(idx, shared_dict_defs.size());

  size_t ret_val_idx = idx;
  for (size_t j = 0; j < shared_dict_defs.size(); j++) {
    for (size_t i = 0; i < shared_dict_defs.size(); ++i) {
      if (!shared_dict_defs[i].get_column().compare(
              shared_dict_defs[ret_val_idx].get_foreign_column())) {
        ret_val_idx = i;
        break;
      }
    }
    if (shared_dict_defs[ret_val_idx].get_foreign_table().compare(
            cur_node.get_foreign_table())) {
      // found a dictionary share definition which shares the dict outside this table to
      // be created
      break;
    }
  }

  return shared_dict_defs[ret_val_idx];
}

Here is the call graph for this function:

Here is the caller graph for this function:

void validate_shared_dictionary	(	const Parser::CreateTableBaseStmt *	stmt,
		const Parser::SharedDictionaryDef *	shared_dict_def,
		const std::list< ColumnDescriptor > &	columns,
		const std::vector< Parser::SharedDictionaryDef > &	shared_dict_defs_so_far,
		const Catalog_Namespace::Catalog &	catalog
	)

Definition at line 129 of file SharedDictionaryValidator.cpp.

References CHECK, ColumnDescriptor::columnName, Parser::SharedDictionaryDef::get_column(), anonymous_namespace{SharedDictionaryValidator.cpp}::get_compression_for_column(), Parser::SharedDictionaryDef::get_foreign_column(), Parser::SharedDictionaryDef::get_foreign_table(), Parser::CreateTableBaseStmt::get_table(), Parser::CreateTableBaseStmt::get_table_element_list(), Catalog_Namespace::Catalog::getAllColumnMetadataForTable(), Catalog_Namespace::Catalog::getMetadataForTable(), kENCODING_DICT, anonymous_namespace{SharedDictionaryValidator.cpp}::lookup_column(), and validate_shared_dictionary_order().

Referenced by Parser::CreateDataframeStmt::execute(), and Parser::CreateTableStmt::executeDryRun().

                                             {
  CHECK(shared_dict_def);
  auto table_name = stmt->get_table();
  const auto cd_ptr = lookup_column(shared_dict_def->get_column(), columns);
  const auto col_qualified_name = *table_name + "." + shared_dict_def->get_column();
  if (!cd_ptr) {
    throw std::runtime_error("Column " + col_qualified_name + " doesn't exist");
  }
  if (!cd_ptr->columnType.is_string() ||
      cd_ptr->columnType.get_compression() != kENCODING_DICT) {
    throw std::runtime_error("Column " + col_qualified_name +
                             " must be a dictionary encoded string");
  }
  const std::list<std::unique_ptr<Parser::TableElement>>& table_element_list =
      stmt->get_table_element_list();
  if (get_compression_for_column(shared_dict_def->get_column(), table_element_list)) {
    throw std::runtime_error(
        "Column " + col_qualified_name +
        " shouldn't specify an encoding, it borrows it from the referenced column");
  }

  // NOTE(Misiu): Unfortunately we have overloaded the term "foreign table" here.  In
  // SharedDictionaryDef the "foreign table" is a table that is sharing a dictionary
  // which it did not create.  This is different from an FSI (HeavyConnect) "foreign
  // table" which is a specific type of table who's data is stored outside of the database
  // system. Currently string dictionaries have some unique handling in FSI (they are
  // populated lazily) so we cannot share them with non-foreign (non-FSI) tables.
  const auto foreign_table_name = shared_dict_def->get_foreign_table();
  const auto foreign_td = catalog.getMetadataForTable(foreign_table_name);
  if (!foreign_td && table_name->compare(foreign_table_name)) {
    throw std::runtime_error("Table " + foreign_table_name + " doesn't exist");
  }

  if (foreign_td) {                      // Dictionary is shared with another table
    if (foreign_td->isForeignTable()) {  // FSI foreign table
      // The 'create foreign table' syntax does not support sharing dictionaries, so we
      // only have to worry about foreign tables being the target of sharing, not the
      // source.
      throw std::runtime_error(
          "Attempting to share dictionary with foreign table " + foreign_table_name +
          ".  Foreign table dictionaries cannot currently be shared.");
    }
    const auto reference_columns =
        catalog.getAllColumnMetadataForTable(foreign_td->tableId, false, false, false);
    const auto reference_cd_ptr =
        lookup_column(shared_dict_def->get_foreign_column(), reference_columns);
    if (!reference_cd_ptr) {
      throw std::runtime_error("Could not find referenced column " +
                               shared_dict_def->get_foreign_column() + " in table " +
                               foreign_td->tableName);
    }
    if (!reference_cd_ptr->columnType.is_string() ||
        reference_cd_ptr->columnType.get_compression() != kENCODING_DICT) {
      const auto reference_col_qualified_name =
          reference_cd_ptr->columnName + "." + shared_dict_def->get_foreign_column();
      throw std::runtime_error("Referenced column " + reference_col_qualified_name +
                               " must be a dictionary encoded string column");
    }
  } else {
    // The dictionary is to be shared within table
    const auto reference_col_qualified_name =
        *table_name + "." + shared_dict_def->get_foreign_column();
    const auto reference_cd_ptr =
        lookup_column(shared_dict_def->get_foreign_column(), columns);
    if (!reference_cd_ptr) {
      throw std::runtime_error("Column " + reference_col_qualified_name +
                               " doesn't exist");
    }
    if (!reference_cd_ptr->columnType.is_string() ||
        reference_cd_ptr->columnType.get_compression() != kENCODING_DICT) {
      throw std::runtime_error("Column " + reference_col_qualified_name +
                               " must be a dictionary encoded string");
    }
    validate_shared_dictionary_order(
        stmt, shared_dict_def, shared_dict_defs_so_far, columns);
  }
  const auto it =
      std::find_if(shared_dict_defs_so_far.begin(),
                   shared_dict_defs_so_far.end(),
                   [shared_dict_def](const Parser::SharedDictionaryDef& elem) {
                     return elem.get_column() == shared_dict_def->get_column();
                   });
  if (it != shared_dict_defs_so_far.end()) {
    throw std::runtime_error("Duplicate shared dictionary hint for column " +
                             *table_name + "." + shared_dict_def->get_column());
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

void validate_shared_dictionary_order	(	const Parser::CreateTableBaseStmt *	stmt,
		const Parser::SharedDictionaryDef *	shared_dict_def,
		const std::vector< Parser::SharedDictionaryDef > &	shared_dict_defs,
		const std::list< ColumnDescriptor > &	columns
	)

Definition at line 60 of file SharedDictionaryValidator.cpp.

References CHECK, Parser::SharedDictionaryDef::get_column(), Parser::SharedDictionaryDef::get_foreign_column(), Parser::SharedDictionaryDef::get_foreign_table(), and Parser::CreateTableBaseStmt::get_table().

Referenced by validate_shared_dictionary().

                                              {
  std::string reference_col_qualified_name =
      shared_dict_def->get_foreign_column() + "." + shared_dict_def->get_foreign_table();
  if (!shared_dict_def->get_column().compare(shared_dict_def->get_foreign_column())) {
    throw std::runtime_error(
        "Dictionary cannot be shared with itself. For dictionary : " +
        reference_col_qualified_name);
  }
  auto table_name = stmt->get_table();
  CHECK(!shared_dict_def->get_foreign_table().compare(*table_name));
  auto col = std::find_if(
      columns.rbegin(), columns.rend(), [shared_dict_def](const ColumnDescriptor& elem) {
        return !elem.columnName.compare(shared_dict_def->get_column());
      });
  CHECK(col != columns.rend());
  auto ref_col =
      std::find_if(col, columns.rend(), [shared_dict_def](const ColumnDescriptor& elem) {
        return !elem.columnName.compare(shared_dict_def->get_foreign_column());
      });

  if (ref_col == columns.rend()) {
    throw std::runtime_error("Dictionary dependencies might create a cycle for " +
                             shared_dict_def->get_column() + "referencing " +
                             reference_col_qualified_name);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function: