src/nominatim_core/db/status.py

   1 # SPDX-License-Identifier: GPL-3.0-or-later
   2 #
   3 # This file is part of Nominatim. (https://nominatim.org)
   4 #
   5 # Copyright (C) 2024 by the Nominatim developer community.
   6 # For a full list of authors see the git log.
   7 """
   8 Access and helper functions for the status and status log table.
   9 """
  10 from typing import Optional, Tuple, cast
  11 import datetime as dt
  12 import logging
  13 import re
  14
  15 from .connection import Connection
  16 from ..utils.url_utils import get_url
  17 from ..errors import UsageError
  18 from ..typing import TypedDict
  19
  20 LOG = logging.getLogger()
  21 ISODATE_FORMAT = '%Y-%m-%dT%H:%M:%S'
  22
  23
  24 class StatusRow(TypedDict):
  25     """ Dictionary of columns of the import_status table.
  26     """
  27     lastimportdate: dt.datetime
  28     sequence_id: Optional[int]
  29     indexed: Optional[bool]
  30
  31
  32 def compute_database_date(conn: Connection, offline: bool = False) -> dt.datetime:
  33     """ Determine the date of the database from the newest object in the
  34         data base.
  35     """
  36     # If there is a date from osm2pgsql available, use that.
  37     if conn.table_exists('osm2pgsql_properties'):
  38         with conn.cursor() as cur:
  39             cur.execute(""" SELECT value FROM osm2pgsql_properties
  40                             WHERE property = 'current_timestamp' """)
  41             row = cur.fetchone()
  42             if row is not None:
  43                 return dt.datetime.strptime(row[0], "%Y-%m-%dT%H:%M:%SZ")\
  44                                   .replace(tzinfo=dt.timezone.utc)
  45
  46     if offline:
  47         raise UsageError("Cannot determine database date from data in offline mode.")
  48
  49     # Else, find the node with the highest ID in the database
  50     with conn.cursor() as cur:
  51         if conn.table_exists('place'):
  52             osmid = cur.scalar("SELECT max(osm_id) FROM place WHERE osm_type='N'")
  53         else:
  54             osmid = cur.scalar("SELECT max(osm_id) FROM placex WHERE osm_type='N'")
  55
  56         if osmid is None:
  57             LOG.fatal("No data found in the database.")
  58             raise UsageError("No data found in the database.")
  59
  60     LOG.info("Using node id %d for timestamp lookup", osmid)
  61     # Get the node from the API to find the timestamp when it was created.
  62     node_url = f'https://www.openstreetmap.org/api/0.6/node/{osmid}/1'
  63     data = get_url(node_url)
  64
  65     match = re.search(r'timestamp="((\d{4})-(\d{2})-(\d{2})T(\d{2}):(\d{2}):(\d{2}))Z"', data)
  66
  67     if match is None:
  68         LOG.fatal("The node data downloaded from the API does not contain valid data.\n"
  69                   "URL used: %s", node_url)
  70         raise UsageError("Bad API data.")
  71
  72     LOG.debug("Found timestamp %s", match.group(1))
  73
  74     return dt.datetime.strptime(match.group(1), ISODATE_FORMAT).replace(tzinfo=dt.timezone.utc)
  75
  76
  77 def set_status(conn: Connection, date: Optional[dt.datetime],
  78                seq: Optional[int] = None, indexed: bool = True) -> None:
  79     """ Replace the current status with the given status. If date is `None`
  80         then only sequence and indexed will be updated as given. Otherwise
  81         the whole status is replaced.
  82         The change will be committed to the database.
  83     """
  84     assert date is None or date.tzinfo == dt.timezone.utc
  85     with conn.cursor() as cur:
  86         if date is None:
  87             cur.execute("UPDATE import_status set sequence_id = %s, indexed = %s",
  88                         (seq, indexed))
  89         else:
  90             cur.execute("TRUNCATE TABLE import_status")
  91             cur.execute("""INSERT INTO import_status (lastimportdate, sequence_id, indexed)
  92                            VALUES (%s, %s, %s)""", (date, seq, indexed))
  93
  94     conn.commit()
  95
  96
  97 def get_status(conn: Connection) -> Tuple[Optional[dt.datetime], Optional[int], Optional[bool]]:
  98     """ Return the current status as a triple of (date, sequence, indexed).
  99         If status has not been set up yet, a triple of None is returned.
 100     """
 101     with conn.cursor() as cur:
 102         cur.execute("SELECT * FROM import_status LIMIT 1")
 103         if cur.rowcount < 1:
 104             return None, None, None
 105
 106         row = cast(StatusRow, cur.fetchone())
 107         return row['lastimportdate'], row['sequence_id'], row['indexed']
 108
 109
 110 def set_indexed(conn: Connection, state: bool) -> None:
 111     """ Set the indexed flag in the status table to the given state.
 112     """
 113     with conn.cursor() as cur:
 114         cur.execute("UPDATE import_status SET indexed = %s", (state, ))
 115     conn.commit()
 116
 117
 118 def log_status(conn: Connection, start: dt.datetime,
 119                event: str, batchsize: Optional[int] = None) -> None:
 120     """ Write a new status line to the `import_osmosis_log` table.
 121     """
 122     with conn.cursor() as cur:
 123         cur.execute("""INSERT INTO import_osmosis_log
 124                        (batchend, batchseq, batchsize, starttime, endtime, event)
 125                        SELECT lastimportdate, sequence_id, %s, %s, now(), %s FROM import_status""",
 126                     (batchsize, start, event))
 127     conn.commit()