module RailsSqlViews
module ConnectionAdapters # :nodoc:
module SchemaStatements
# Create a view.
# The +options+ hash can include the following keys:
# [:check_option]
# Specify restrictions for inserts or updates in updatable views. ANSI SQL 92 defines two check option
# values: CASCADED and LOCAL. See your database documentation for allowed values.
def create_view(name, select_query, options={})
if supports_views?
view_definition = ViewDefinition.new(self, select_query)
if block_given?
yield view_definition
end
if options[:force]
drop_view(name) rescue nil
end
create_sql = "CREATE VIEW "
create_sql << "#{quote_table_name(name)} "
if supports_view_columns_definition? && !view_definition.to_sql.blank?
create_sql << "("
create_sql << view_definition.to_sql
create_sql << ") "
end
create_sql << "AS #{view_definition.select_query}"
create_sql << " WITH #{options[:check_option]} CHECK OPTION" if options[:check_option]
execute create_sql
end
end
# Also creates a view, with the specific purpose of remapping column names
# to make non-ActiveRecord tables friendly with the naming
# conventions, while maintaining legacy app compatibility.
def create_mapping_view(old_name, new_name, options = {})
return unless supports_views?
col_names = columns(old_name).collect { |col| col.name.to_sym }
mapper = MappingDefinition.new(col_names)
yield mapper
if options[:force]
drop_view(new_name) rescue nil
end
view_sql = "CREATE VIEW #{new_name} "
if supports_view_columns_definition?
view_sql << "(#{mapper.view_cols.collect { |c| quote_column_name(c) }.join(', ')}) "
end
view_sql << "AS SELECT #{mapper.select_cols.collect { |c| quote_column_name(c) }.join(', ')} FROM #{old_name}"
execute view_sql
end
# Drop a view.
# The +options+ hash can include the following keys:
# [:drop_behavior]
# Specify the drop behavior. ANSI SQL 92 defines two drop behaviors, CASCADE and RESTRICT. See your
# database documentation to determine what drop behaviors are available.
def drop_view(name, options={})
if supports_views?
drop_sql = "DROP VIEW #{quote_table_name(name)}"
drop_sql << " #{options[:drop_behavior]}" if options[:drop_behavior]
execute drop_sql
end
end
end
end
end