Nominatim/nominatim/tools/refresh.py

"""
Functions for bringing auxiliary data in the database up-to-date.
"""
import json
import re

from psycopg2.extras import execute_values

from ..db.utils import execute_file

def update_postcodes(conn, sql_dir):
    """ Recalculate postcode centroids and add, remove and update entries in the
        location_postcode table. `conn` is an opne connection to the database.
    """
    execute_file(conn, sql_dir / 'update-postcodes.sql')


def recompute_word_counts(conn, sql_dir):
    """ Compute the frequency of full-word search terms.
    """
    execute_file(conn, sql_dir / 'words_from_search_name.sql')


def _add_address_level_rows_from_entry(rows, entry):
    """ Converts a single entry from the JSON format for address rank
        descriptions into a flat format suitable for inserting into a
        PostgreSQL table and adds these lines to `rows`.
    """
    countries = entry.get('countries') or (None, )
    for key, values in entry['tags'].items():
        for value, ranks in values.items():
            if isinstance(ranks, list):
                rank_search, rank_address = ranks
            else:
                rank_search = rank_address = ranks
            if not value:
                value = None
            for country in countries:
                rows.append((country, key, value, rank_search, rank_address))

def load_address_levels(conn, table, levels):
    """ Replace the `address_levels` table with the contents of `levels'.

        A new table is created any previously existing table is dropped.
        The table has the following columns:
            country, class, type, rank_search, rank_address
    """
    rows = []
    for entry in levels:
        _add_address_level_rows_from_entry(rows, entry)

    with conn.cursor() as cur:
        cur.execute('DROP TABLE IF EXISTS {}'.format(table))

        cur.execute("""CREATE TABLE {} (country_code varchar(2),
                                        class TEXT,
                                        type TEXT,
                                        rank_search SMALLINT,
                                        rank_address SMALLINT)""".format(table))

        execute_values(cur, "INSERT INTO {} VALUES %s".format(table), rows)

        cur.execute('CREATE UNIQUE INDEX ON {} (country_code, class, type)'.format(table))

    conn.commit()

def load_address_levels_from_file(conn, config_file):
    """ Replace the `address_levels` table with the contents of the config
        file.
    """
    with config_file.open('r') as fdesc:
        load_address_levels(conn, 'address_levels', json.load(fdesc))

PLPGSQL_BASE_MODULES = (
    'utils.sql',
    'normalization.sql',
    'ranking.sql',
    'importance.sql',
    'address_lookup.sql',
    'interpolation.sql'
)

PLPGSQL_TABLE_MODULES = (
    ('place', 'place_triggers.sql'),
    ('placex', 'placex_triggers.sql'),
    ('location_postcode', 'postcode_triggers.sql')
)

def _get_standard_function_sql(conn, config, sql_dir, enable_diff_updates, enable_debug):
    """ Read all applicable SQLs containing PL/pgSQL functions, replace
        placefolders and execute them.
    """
    sql_func_dir = sql_dir / 'functions'
    sql = ''

    # Get the basic set of functions that is always imported.
    for sql_file in PLPGSQL_BASE_MODULES:
        with (sql_func_dir / sql_file).open('r') as fdesc:
            sql += fdesc.read()

    # Some files require the presence of a certain table
    for table, fname in PLPGSQL_TABLE_MODULES:
        if conn.table_exists(table):
            with (sql_func_dir / fname).open('r') as fdesc:
                sql += fdesc.read()

    # Replace placeholders.
    sql = sql.replace('{modulepath}',
                      config.DATABASE_MODULE_PATH or str((config.project_dir / 'module').resolve()))

    if enable_diff_updates:
        sql = sql.replace('RETURN NEW; -- %DIFFUPDATES%', '--')

    if enable_debug:
        sql = sql.replace('--DEBUG:', '')

    if config.get_bool('LIMIT_REINDEXING'):
        sql = sql.replace('--LIMIT INDEXING:', '')

    if not config.get_bool('USE_US_TIGER_DATA'):
        sql = sql.replace('-- %NOTIGERDATA% ', '')

    if not config.get_bool('USE_AUX_LOCATION_DATA'):
        sql = sql.replace('-- %NOAUXDATA% ', '')

    reverse_only = 'false' if conn.table_exists('search_name') else 'true'

    return sql.replace('%REVERSE-ONLY%', reverse_only)


def replace_partition_string(sql, partitions):
    """ Replace a partition template with the actual partition code.
    """
    for match in re.findall('^-- start(.*?)^-- end', sql, re.M | re.S):
        repl = ''
        for part in partitions:
            repl += match.replace('-partition-', str(part))
        sql = sql.replace(match, repl)

    return sql

def _get_partition_function_sql(conn, sql_dir):
    """ Create functions that work on partition tables.
    """
    with conn.cursor() as cur:
        cur.execute('SELECT distinct partition FROM country_name')
        partitions = set([0])
        for row in cur:
            partitions.add(row[0])

    with (sql_dir / 'partition-functions.src.sql').open('r') as fdesc:
        sql = fdesc.read()

    return replace_partition_string(sql, sorted(partitions))

def create_functions(conn, config, sql_dir,
                     enable_diff_updates=True, enable_debug=False):
    """ (Re)create the PL/pgSQL functions.
    """
    sql = _get_standard_function_sql(conn, config, sql_dir,
                                     enable_diff_updates, enable_debug)
    sql += _get_partition_function_sql(conn, sql_dir)

    with conn.cursor() as cur:
        cur.execute(sql)

    conn.commit()