kaqing 2.0.115__py3-none-any.whl → 2.0.172__py3-none-any.whl

adam/commands/export/exporter.py

@@ -0,0 +1,353 @@
+from datetime import datetime
+import functools
+import re
+import time
+
+from adam.commands.cql.utils_cql import cassandra_table_names, run_cql, table_spec
+from adam.commands.export.export_databases import ExportDatabases
+from adam.commands.export.importer import Importer
+from adam.commands.export.importer_athena import AthenaImporter
+from adam.commands.export.importer_sqlite import SqliteImporter
+from adam.commands.export.utils_export import ExportSpec, ExportTableStatus, ExportTableSpec, ImportSpec, csv_dir, find_files
+from adam.config import Config
+from adam.pod_exec_result import PodExecResult
+from adam.repl_state import ReplState
+from adam.utils import debug, parallelize, log2, ing, log_exc
+from adam.utils_k8s.cassandra_nodes import CassandraNodes
+from adam.utils_k8s.pods import log_prefix
+from adam.utils_k8s.statefulsets import StatefulSets
+
+class Exporter:
+    def export_tables(args: list[str], state: ReplState, export_only: bool = False, max_workers = 0) -> tuple[list[str], ExportSpec]:
+        if export_only:
+            log2('export-only for testing')
+
+        spec: ExportSpec = None
+        with log_exc(True):
+            spec = Exporter.export_spec(' '.join(args), state)
+
+            statuses, spec = Exporter._export_tables(spec, state, max_workers=max_workers, export_state='init')
+            if not statuses:
+                return statuses, spec
+
+            return Exporter._export_tables(spec, state, export_only, max_workers, 'pending_export')
+
+        return [], None
+
+    def export_spec(spec_str: str, state: ReplState):
+        spec: ExportSpec = ExportSpec.parse_specs(spec_str)
+
+        session = state.export_session
+        if session:
+            if spec.importer:
+                importer_from_session = Importer.importer_from_session(session)
+                if spec.importer != importer_from_session:
+                    if spec.importer == 'csv':
+                        prefix = Importer.prefix_from_importer(spec.importer)
+                        session = f'{prefix}{session[1:]}'
+                    else:
+                        raise Exception(f"You're currently using {importer_from_session} export database. You cannot export tables with {spec.importer} type database.")
+            else:
+                spec.importer = Importer.importer_from_session(session)
+
+            if spec.importer == 'athena' and not AthenaImporter.ping():
+                raise Exception('Credentials for Athena is not present.')
+        else:
+            if not spec.importer:
+                spec.importer = Config().get('export.default-importer', 'sqlite')
+
+            prefix = Importer.prefix_from_importer(spec.importer)
+            session = f'{prefix}{datetime.now().strftime("%Y%m%d%H%M%S")[3:]}'
+
+            if spec.importer == 'athena' and not AthenaImporter.ping():
+                raise Exception('Credentials for Athena is not present.')
+
+            if spec.importer != 'csv':
+                state.export_session = session
+
+        spec.session = session
+
+        return spec
+
+    def import_session(args: list[str], state: ReplState, max_workers = 0) -> tuple[list[str], ExportSpec]:
+        import_spec: ImportSpec = None
+        with log_exc(True):
+            import_spec = Exporter.import_spec(' '.join(args), state)
+            tables, status_in_whole = ExportTableStatus.from_session(state.sts, state.pod, state.namespace, import_spec.session)
+            if status_in_whole == 'done':
+                log2(f'The session has been completely done - no more csv files are found.')
+                return [], ExportSpec(None, None, importer=import_spec.importer, tables=[])
+
+            spec = ExportSpec(None, None, importer=import_spec.importer, tables=[ExportTableSpec.from_status(table) for table in tables], session=import_spec.session)
+
+            return Exporter._export_tables(spec, state, max_workers=max_workers, export_state = 'import')
+
+        return [], None
+
+    def import_spec(spec_str: str, state: ReplState):
+        spec: ImportSpec = ImportSpec.parse_specs(spec_str)
+
+        session = state.export_session
+        if session:
+            if spec.importer:
+                importer = Importer.importer_from_session(state.export_session)
+                if spec.importer != importer:
+                    raise Exception(f"You're currently using {importer} export database. You cannot import to {spec.importer} type database.")
+            else:
+                spec.importer = Importer.importer_from_session(state.export_session)
+                if not spec.importer:
+                    spec.importer = Config().get('export.default-importer', 'sqlite')
+
+            if spec.importer == 'athena' and not AthenaImporter.ping():
+                raise Exception('Credentials for Athena is not present.')
+        else:
+            if not spec.importer:
+                spec.importer = Importer.importer_from_session(spec.session)
+
+            if spec.importer == 'csv':
+                spec.importer = Config().get('export.default-importer', 'sqlite')
+
+            if spec.importer == 'athena' and not AthenaImporter.ping():
+                raise Exception('Credentials for Athena is not present.')
+
+            prefix = Importer.prefix_from_importer(spec.importer)
+            session = f'{prefix}{spec.session[1:]}'
+            state.export_session = session
+
+        return spec
+
+    def _export_tables(spec: ExportSpec, state: ReplState, export_only = False, max_workers = 0, export_state = None) -> tuple[list[str], ExportSpec]:
+        if not spec.keyspace:
+            spec.keyspace = f'{state.namespace}_db'
+
+        if not spec.tables:
+            spec.tables = [ExportTableSpec.parse(t) for t in cassandra_table_names(state, keyspace=spec.keyspace)]
+
+        if not max_workers:
+            max_workers = Config().action_workers(f'export.{spec.importer}', 8)
+
+        if export_state == 'init':
+            CassandraNodes.exec(state.pod, state.namespace, f'rm -rf {csv_dir()}/{spec.session}_*', show_out=Config().is_debug(), shell='bash')
+
+        action = f'[{spec.session}] Exporting|Exported'
+        if export_state == 'init':
+            action = f'[{spec.session}] Preparing|Prepared'
+        elif export_state == 'import':
+            action = f'[{spec.session}] Importing|Imported'
+
+        with parallelize(spec.tables, max_workers, msg=action + ' {size} Cassandra tables') as exec:
+            return exec.map(lambda table: Exporter.export_table(table, state, spec.session, spec.importer, export_only, len(spec.tables) > 1, consistency=spec.consistency, export_state=export_state)), spec
+
+    def export_table(spec: ExportTableSpec, state: ReplState, session: str, importer: str, export_only = False, multi_tables = True, consistency: str = None, export_state=None):
+        s: str = None
+
+        table, target_table, columns = Exporter.resove_table_n_columns(spec, state, include_ks_in_target=False, importer=importer)
+
+        log_file = f'{log_prefix()}-{session}_{spec.keyspace}.{target_table}.log'
+        create_db = not state.export_session
+
+        if export_state == 'init':
+            Exporter.create_table_log(spec, state, session, table, target_table)
+            return 'table_log_created'
+        else:
+            if export_state == 'pending_export':
+                Exporter.export_to_csv(spec, state, session, table, target_table, columns, multi_tables=multi_tables, consistency=consistency)
+
+            log_files: list[str] = find_files(state.pod, state.namespace, f'{log_file}*')
+            if not log_files:
+                return s
+
+            log_file = log_files[0]
+
+            status: ExportTableStatus = ExportTableStatus.from_log_file(state.pod, state.namespace, session, log_file)
+            while status.status != 'done':
+                if status.status == 'export_in_pregress':
+                    debug('Exporting to CSV is still in progess, sleeping for 1 sec...')
+                    time.sleep(1)
+                elif status.status == 'exported':
+                    log_file = Exporter.rename_to_pending_import(spec, state, session, target_table)
+                    if importer == 'csv' or export_only:
+                        return 'pending_import'
+                elif status.status == 'pending_import':
+                    log_file, session = Exporter.import_from_csv(spec, state, session, importer, table, target_table, columns, multi_tables=multi_tables, create_db=create_db)
+
+                status = ExportTableStatus.from_log_file(state.pod, state.namespace, session, log_file)
+
+            return status.status
+
+    def create_table_log(spec: ExportTableSpec, state: ReplState, session: str, table: str, target_table: str):
+        log_file = f'{log_prefix()}-{session}_{spec.keyspace}.{target_table}.log'
+
+        CassandraNodes.exec(state.pod, state.namespace, f'rm -f {log_file}* && touch {log_file}', show_out=Config().is_debug(), shell='bash')
+
+        return table
+
+    def export_to_csv(spec: ExportTableSpec, state: ReplState, session: str, table: str, target_table: str, columns: str, multi_tables = True, consistency: str = None):
+        db = f'{session}_{target_table}'
+
+        CassandraNodes.exec(state.pod, state.namespace, f'mkdir -p {csv_dir()}/{db}', show_out=Config().is_debug(), shell='bash')
+        csv_file = f'{csv_dir()}/{db}/{table}.csv'
+        log_file = f'{log_prefix()}-{session}_{spec.keyspace}.{target_table}.log'
+
+        suppress_ing_log = Config().is_debug() or multi_tables
+        queries = []
+        if consistency:
+            queries.append(f'CONSISTENCY {consistency}')
+        queries.append(f"COPY {spec.keyspace}.{table}({columns}) TO '{csv_file}' WITH HEADER = TRUE")
+        r: PodExecResult = ing(
+            f'[{session}] Dumping table {spec.keyspace}.{table}{f" with consistency {consistency}" if consistency else ""}',
+            lambda: run_cql(state, ';'.join(queries), show_out=Config().is_debug(), background=True, log_file=log_file),
+            suppress_log=suppress_ing_log)
+
+        return log_file
+
+    def rename_to_pending_import(spec: ExportTableSpec, state: ReplState, session: str, target_table: str):
+        log_file = f'{log_prefix()}-{session}_{spec.keyspace}.{target_table}.log'
+        to = f'{log_file}.pending_import'
+
+        CassandraNodes.exec(state.pod, state.namespace, f'mv {log_file} {to}', show_out=Config().is_debug(), shell='bash')
+
+        return to
+
+    def import_from_csv(spec: ExportTableSpec, state: ReplState, session: str, importer: str, table: str, target_table: str, columns: str, multi_tables = True, create_db = False):
+        im = AthenaImporter() if importer == 'athena' else SqliteImporter()
+        return im.import_from_csv(state.pod, state.namespace, state.export_session, session if session else state.export_session, spec.keyspace, table, target_table, columns, multi_tables, create_db)
+
+    def clear_export_session_cache():
+        Exporter.find_export_sessions.cache_clear()
+        Exporter.export_session_names.cache_clear()
+
+    @functools.lru_cache()
+    def export_session_names(sts: str, pod: str, namespace: str, importer: str = None, export_state = None):
+        if not sts or not namespace:
+            return []
+
+        if not pod:
+            pod = StatefulSets.pod_names(sts, namespace)[0]
+
+        if not pod:
+            return []
+
+        return [session for session, state in Exporter.find_export_sessions(pod, namespace, importer).items() if not export_state or state == export_state]
+
+    @functools.lru_cache()
+    def find_export_sessions(pod: str, namespace: str, importer: str = None, limit = 100):
+        sessions: dict[str, str] = {}
+
+        prefix = Importer.prefix_from_importer(importer)
+
+        log_files: list[str] = find_files(pod, namespace, f'{log_prefix()}-{prefix}*_*.log*')
+
+        if not log_files:
+            return {}
+
+        for log_file in log_files[:limit]:
+            m = re.match(f'{log_prefix()}-(.*?)_.*\.log?(.*)', log_file)
+            if m:
+                s = m.group(1)
+                state = m.group(2) # '', '.pending_import', '.done'
+                if state:
+                    state = state.strip('.')
+                else:
+                    state = 'in_export'
+
+                if s not in sessions:
+                    sessions[s] = state
+                elif sessions[s] == 'done' and state != 'done':
+                    sessions[s] = state
+
+        return sessions
+
+    def clean_up_all_sessions(sts: str, pod: str, namespace: str):
+        if not sts or not namespace:
+            return False
+
+        if not pod:
+            pod = StatefulSets.pod_names(sts, namespace)[0]
+
+        CassandraNodes.exec(pod, namespace, f'rm -rf {csv_dir()}/*', show_out=Config().is_debug(), shell='bash')
+        CassandraNodes.exec(pod, namespace, f'rm -rf {log_prefix()}-*.log*', show_out=Config().is_debug(), shell='bash')
+
+        return True
+
+    def clean_up_sessions(sts: str, pod: str, namespace: str, sessions: list[str], max_workers = 0):
+        if not sessions:
+            return []
+
+        if not max_workers:
+            max_workers = Config().action_workers('export', 8)
+
+        with parallelize(sessions, max_workers, msg='Cleaning|Cleaned up {size} export sessions') as exec:
+            cnt_tuples = exec.map(lambda session: Exporter.clean_up_session(sts, pod, namespace, session, True))
+            csv_cnt = 0
+            log_cnt = 0
+            for (csv, log) in cnt_tuples:
+                csv_cnt += csv
+                log_cnt += log
+
+            return csv_cnt, log_cnt
+
+    def clean_up_session(sts: str, pod: str, namespace: str, session: str, multi_tables = True):
+        if not sts or not namespace:
+            return 0, 0
+
+        if not pod:
+            pod = StatefulSets.pod_names(sts, namespace)[0]
+
+        if not pod:
+            return 0, 0
+
+        csv_cnt = 0
+        log_cnt = 0
+
+        log_files: list[str] = find_files(pod, namespace, f'{log_prefix()}-{session}_*.log*')
+
+        for log_file in log_files:
+            m = re.match(f'{log_prefix()}-{session}_(.*?)\.(.*?)\.log.*', log_file)
+            if m:
+                table = m.group(2)
+
+                CassandraNodes.exec(pod, namespace, f'rm -rf {csv_dir()}/{session}_{table}', show_out=not multi_tables, shell='bash')
+                csv_cnt += 1
+
+                CassandraNodes.exec(pod, namespace, f'rm -rf {log_file}', show_out=not multi_tables, shell='bash')
+                log_cnt += 1
+
+        return csv_cnt, log_cnt
+
+    def resove_table_n_columns(spec: ExportTableSpec, state: ReplState, include_ks_in_target = False, importer = 'sqlite'):
+        table = spec.table
+        columns = spec.columns
+        if not columns:
+            columns = Config().get(f'export.{importer}.columns', f'<keys>')
+
+        keyspaced_table = f'{spec.keyspace}.{spec.table}'
+        if columns == '<keys>':
+            columns = ','.join(table_spec(state, keyspaced_table, on_any=True).keys())
+        elif columns == '<row-key>':
+            columns = table_spec(state, keyspaced_table, on_any=True).row_key()
+        elif columns == '*':
+            columns = ','.join([c.name for c in table_spec(state, keyspaced_table, on_any=True).columns])
+
+        if not columns:
+            log2(f'ERROR: Empty columns on {table}.')
+            return table, None, None
+
+        target_table = spec.target_table if spec.target_table else table
+        if not include_ks_in_target and '.' in target_table:
+            target_table = target_table.split('.')[-1]
+
+        return table, target_table, columns
+
+    def drop_databases(sts: str, pod: str, namespace: str, db: str = None):
+        importer = None
+        if db:
+            importer = Importer.importer_from_session(db)
+
+        sessions_done = Exporter.export_session_names(sts, pod, namespace, importer=importer, export_state='done')
+        sessions = ExportDatabases.sessions_from_dbs(ExportDatabases.drop_export_dbs(db))
+        if sessions_done and sessions:
+            intersects = list(set(sessions_done) & set(sessions))
+            with ing(f'Cleaning up {len(intersects)} completed sessions'):
+                Exporter.clean_up_sessions(sts, pod, namespace, list(intersects))
+                Exporter.clear_export_session_cache()

adam/commands/export/import_session.py

@@ -0,0 +1,40 @@
+from adam.commands.command import Command
+from adam.commands.export.export_handlers import export
+from adam.commands.export.exporter import Exporter
+from adam.repl_state import ReplState, RequiredState
+
+class ImportSession(Command):
+    COMMAND = 'import session'
+
+    # the singleton pattern
+    def __new__(cls, *args, **kwargs):
+        if not hasattr(cls, 'instance'): cls.instance = super(ImportSession, cls).__new__(cls)
+
+        return cls.instance
+
+    def __init__(self, successor: Command=None):
+        super().__init__(successor)
+
+    def command(self):
+        return ImportSession.COMMAND
+
+    def required(self):
+        return RequiredState.CLUSTER_OR_POD
+
+    def run(self, cmd: str, state: ReplState):
+        if not(args := self.args(cmd)):
+            return super().run(cmd, state)
+
+        with self.validate(args, state) as (args, state):
+            with export(state) as exporter:
+                return exporter.import_sesion(args)
+
+    def completion(self, state: ReplState):
+        # warm up cache
+        Exporter.export_session_names(state.sts, state.pod, state.namespace)
+        Exporter.export_session_names(state.sts, state.pod, state.namespace, export_state='pending_import')
+
+        return {}
+
+    def help(self, _: ReplState):
+        return f'{ImportSession.COMMAND} <export-session-name>\t import files in session to Athena or SQLite'

adam/commands/export/importer.py

@@ -0,0 +1,67 @@
+from abc import abstractmethod
+
+from adam.commands.export.utils_export import csv_dir
+from adam.config import Config
+from adam.utils import ing
+from adam.utils_k8s.cassandra_nodes import CassandraNodes
+from adam.utils_k8s.pods import log_prefix
+
+class Importer:
+    @abstractmethod
+    def prefix(self):
+        pass
+
+    @abstractmethod
+    def import_from_csv(self, pod: str, namespace: str, to_session: str, from_session: str, keyspace: str, table: str, target_table: str, columns: str, multi_tables = True, create_db = False):
+        pass
+
+    def move_to_done(self, pod: str, namespace: str, to_session: str, from_session: str, keyspace: str, target_table: str):
+        log_file = f'{log_prefix()}-{from_session}_{keyspace}.{target_table}.log.pending_import'
+
+        to = f'{log_prefix()}-{to_session}_{keyspace}.{target_table}.log.done'
+
+        CassandraNodes.exec(pod, namespace, f'mv {log_file} {to}', show_out=Config().is_debug(), shell='bash')
+
+        return to, to_session
+
+    def prefix_adjusted_session(self, session: str):
+        if not session.startswith(self.prefix()):
+            return f'{self.prefix()}{session[1:]}'
+
+        return session
+
+    def remove_csv(self, pod: str, namespace: str, session: str, table: str, target_table: str, multi_tables = True):
+        with ing(f'[{session}] Cleaning up temporary files', suppress_log=multi_tables):
+            CassandraNodes.exec(pod, namespace, f'rm -rf {self.csv_file(session, table, target_table)}', show_out=Config().is_debug(), shell='bash')
+
+    def db(self, session: str, keyspace: str):
+        return f'{session}_{keyspace}'
+
+    def csv_file(self, session: str, table: str, target_table: str):
+        return f'{csv_dir()}/{session}_{target_table}/{table}.csv'
+
+    def prefix_from_importer(importer: str = ''):
+        if not importer:
+            return ''
+
+        prefix = 's'
+
+        if importer == 'athena':
+            prefix = 'e'
+        elif importer == 'csv':
+            prefix = 'c'
+
+        return prefix
+
+    def importer_from_session(session: str):
+        if not session:
+            return None
+
+        importer = 'csv'
+
+        if session.startswith('s'):
+            importer = 'sqlite'
+        elif session.startswith('e'):
+            importer = 'athena'
+
+        return importer

adam/commands/export/importer_athena.py

@@ -0,0 +1,77 @@
+import boto3
+
+from adam.commands.export.importer import Importer
+from adam.commands.export.utils_export import GeneratorStream
+from adam.config import Config
+from adam.utils import debug, log2, ing
+from adam.utils_athena import Athena
+from adam.utils_k8s.pods import Pods
+
+class AthenaImporter(Importer):
+    def ping():
+        session = boto3.session.Session()
+        credentials = session.get_credentials()
+
+        return credentials is not None
+
+    def prefix(self):
+        return 'e'
+
+    def import_from_csv(self, pod: str, namespace: str, to_session: str, from_session: str, keyspace: str, table: str, target_table: str, columns: str, multi_tables = True, create_db = False):
+        csv_file = self.csv_file(from_session, table, target_table)
+        db = self.db(to_session, keyspace)
+
+        succeeded = False
+        try:
+            bucket = Config().get('export.bucket', 'c3.ops--qing')
+
+            with ing(f'[{to_session}] Uploading to S3', suppress_log=multi_tables):
+                bytes = Pods.read_file(pod, 'cassandra', namespace, csv_file)
+
+                s3 = boto3.client('s3')
+                s3.upload_fileobj(GeneratorStream(bytes), bucket, f'export/{db}/{keyspace}/{target_table}/{table}.csv')
+
+            msg: str = None
+            if create_db:
+                msg = f"[{to_session}] Creating database {db}"
+            else:
+                msg = f"[{to_session}] Creating table {target_table}"
+            with ing(msg, suppress_log=multi_tables):
+                query = f'CREATE DATABASE IF NOT EXISTS {db};'
+                debug(query)
+                Athena.query(query, 'default')
+
+                query = f'DROP TABLE IF EXISTS {target_table};'
+                debug(query)
+                Athena.query(query, db)
+
+                athena_columns = ', '.join([f'{c} string' for c in columns.split(',')])
+                query = f'CREATE EXTERNAL TABLE IF NOT EXISTS {target_table}(\n' + \
+                        f'    {athena_columns})\n' + \
+                            "ROW FORMAT SERDE 'org.apache.hadoop.hive.serde2.OpenCSVSerde'\n" + \
+                            'WITH SERDEPROPERTIES (\n' + \
+                            '    "separatorChar" = ",",\n' + \
+                            '    "quoteChar"     = "\\"")\n' + \
+                        f"LOCATION 's3://{bucket}/export/{db}/{keyspace}/{target_table}'\n" + \
+                            'TBLPROPERTIES ("skip.header.line.count"="1");'
+                debug(query)
+                try:
+                    Athena.query(query, db)
+                except Exception as e:
+                    log2(f'*** Failed query:\n{query}')
+                    raise e
+
+            to, _ = self.move_to_done(pod, namespace, to_session, from_session, keyspace, target_table)
+
+            succeeded = True
+
+            return to, to_session
+        finally:
+            if succeeded:
+                self.remove_csv(pod, namespace, from_session, table, target_table, multi_tables)
+                Athena.clear_cache()
+
+                if not multi_tables:
+                    query = f'select * from {target_table} limit 10'
+                    log2(query)
+                    Athena.run_query(query, db)

adam/commands/export/importer_sqlite.py

@@ -0,0 +1,39 @@
+import pandas
+
+from adam.commands.export.importer import Importer
+from adam.commands.export.utils_export import GeneratorStream
+from adam.utils import log2, ing
+from adam.utils_k8s.pods import Pods
+from adam.utils_sqlite import SQLite, sqlite
+
+class SqliteImporter(Importer):
+    def prefix(self):
+        return 's'
+
+    def import_from_csv(self, pod: str, namespace: str, to_session: str, from_session: str, keyspace: str, table: str, target_table: str, columns: str, multi_tables = True, create_db = False):
+        csv_file = self.csv_file(from_session, table, target_table)
+
+        succeeded = False
+        with sqlite(to_session, keyspace) as conn:
+            try:
+                with ing(f'[{to_session}] Uploading to Sqlite', suppress_log=multi_tables):
+                    bytes = Pods.read_file(pod, 'cassandra', namespace, csv_file)
+                    df = pandas.read_csv(GeneratorStream(bytes))
+
+                    df.to_sql(target_table, conn, index=False, if_exists='replace')
+
+                to, _ = self.move_to_done(pod, namespace, to_session, from_session, keyspace, target_table)
+
+                succeeded = True
+
+                return to, to_session
+            finally:
+                if succeeded:
+                    self.remove_csv(pod, namespace, from_session, table, target_table, multi_tables)
+                    SQLite.clear_cache()
+
+                    if not multi_tables:
+                        with sqlite(to_session) as conn:
+                            query = f'select * from {keyspace}.{target_table} limit 10'
+                            log2(query)
+                            SQLite.run_query_with_conn(conn, query)

adam/commands/export/show_column_counts.py

@@ -0,0 +1,54 @@
+from adam.commands.command import Command
+from adam.commands.export.export_databases import ExportDatabases
+from adam.config import Config
+from adam.repl_state import ReplState, RequiredState
+from adam.utils import log2
+
+class ShowColumnCounts(Command):
+    COMMAND = 'show column counts on'
+
+    # the singleton pattern
+    def __new__(cls, *args, **kwargs):
+        if not hasattr(cls, 'instance'): cls.instance = super(ShowColumnCounts, cls).__new__(cls)
+
+        return cls.instance
+
+    def __init__(self, successor: Command=None):
+        super().__init__(successor)
+
+    def command(self):
+        return ShowColumnCounts.COMMAND
+
+    def required(self):
+        return RequiredState.EXPORT_DB
+
+    def run(self, cmd: str, state: ReplState):
+        if not(args := self.args(cmd)):
+            return super().run(cmd, state)
+
+        with self.validate(args, state) as (args, state):
+            if not args:
+                if state.in_repl:
+                    log2('Use a SQL statement.')
+                else:
+                    log2('* SQL statement is missing.')
+
+                    Command.display_help()
+
+                return 'command-missing'
+
+            table = args[0]
+            query = Config().get(f'export.column_counts_query', 'select id, count(id) as columns from {table} group by id')
+            query = query.replace('{table}', table)
+            ExportDatabases.run_query(query, state.export_session)
+
+            return state
+
+    def completion(self, state: ReplState):
+        if not state.export_session:
+            return {}
+
+        return super().completion(state, lambda: {t: None for t in ExportDatabases.table_names(state.export_session)})
+
+    def help(self, _: ReplState):
+        return f'{ShowColumnCounts.COMMAND} <export-table-name>\t show column count per id'

adam/commands/export/show_export_databases.py

@@ -0,0 +1,36 @@
+from adam.commands.command import Command
+from adam.commands.devices.device_export import DeviceExport
+from adam.repl_state import ReplState
+
+class ShowExportDatabases(Command):
+    COMMAND = 'show export databases'
+
+    # the singleton pattern
+    def __new__(cls, *args, **kwargs):
+        if not hasattr(cls, 'instance'): cls.instance = super(ShowExportDatabases, cls).__new__(cls)
+
+        return cls.instance
+
+    def __init__(self, successor: Command=None):
+        super().__init__(successor)
+
+    def command(self):
+        return ShowExportDatabases.COMMAND
+
+    def required(self):
+        return [ReplState.C, ReplState.X]
+
+    def run(self, cmd: str, state: ReplState):
+        if not(args := self.args(cmd)):
+            return super().run(cmd, state)
+
+        with self.validate(args, state) as (args, state):
+            DeviceExport().show_export_databases()
+
+            return state
+
+    def completion(self, state: ReplState):
+        return DeviceExport().ls_completion(ShowExportDatabases.COMMAND, state, default = super().completion(state))
+
+    def help(self, _: ReplState):
+        return f'{ShowExportDatabases.COMMAND}\t list export databases'