meerschaum 2.4.13__tar.gz → 2.5.0__tar.gz

{meerschaum-2.4.13/meerschaum.egg-info → meerschaum-2.5.0}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.1
 Name: meerschaum
-Version: 2.4.13
+Version: 2.5.0
 Summary: Sync Time-Series Pipes with Meerschaum
 Home-page: https://meerschaum.io
 Author: Bennett Meares
@@ -48,7 +48,7 @@ Requires-Dist: setuptools>=63.3.0; extra == "core"
 Requires-Dist: PyYAML>=5.3.1; extra == "core"
 Requires-Dist: pip>=22.0.4; extra == "core"
 Requires-Dist: update-checker>=0.18.0; extra == "core"
-Requires-Dist: semver>=3.0.0; extra == "core"
+Requires-Dist: semver>=3.0.2; extra == "core"
 Requires-Dist: pathspec>=0.9.0; extra == "core"
 Requires-Dist: python-dateutil>=2.7.5; extra == "core"
 Requires-Dist: requests>=2.32.3; extra == "core"
@@ -63,8 +63,7 @@ Requires-Dist: prompt-toolkit>=3.0.39; extra == "core"
 Requires-Dist: more-itertools>=8.7.0; extra == "core"
 Requires-Dist: fasteners>=0.19.0; extra == "core"
 Requires-Dist: virtualenv>=20.1.0; extra == "core"
-Requires-Dist: attrs<24.2.0; extra == "core"
-Requires-Dist: APScheduler>=4.0.0a5; extra == "core"
+Requires-Dist: attrs>=24.2.0; extra == "core"
 Requires-Dist: uv>=0.2.11; extra == "core"
 Provides-Extra: jobs
 Requires-Dist: dill>=0.3.3; extra == "jobs"
@@ -147,7 +146,7 @@ Requires-Dist: setuptools>=63.3.0; extra == "sql"
 Requires-Dist: PyYAML>=5.3.1; extra == "sql"
 Requires-Dist: pip>=22.0.4; extra == "sql"
 Requires-Dist: update-checker>=0.18.0; extra == "sql"
-Requires-Dist: semver>=3.0.0; extra == "sql"
+Requires-Dist: semver>=3.0.2; extra == "sql"
 Requires-Dist: pathspec>=0.9.0; extra == "sql"
 Requires-Dist: python-dateutil>=2.7.5; extra == "sql"
 Requires-Dist: requests>=2.32.3; extra == "sql"
@@ -162,8 +161,7 @@ Requires-Dist: prompt-toolkit>=3.0.39; extra == "sql"
 Requires-Dist: more-itertools>=8.7.0; extra == "sql"
 Requires-Dist: fasteners>=0.19.0; extra == "sql"
 Requires-Dist: virtualenv>=20.1.0; extra == "sql"
-Requires-Dist: attrs<24.2.0; extra == "sql"
-Requires-Dist: APScheduler>=4.0.0a5; extra == "sql"
+Requires-Dist: attrs>=24.2.0; extra == "sql"
 Requires-Dist: uv>=0.2.11; extra == "sql"
 Provides-Extra: dash
 Requires-Dist: Flask-Compress>=1.10.1; extra == "dash"
@@ -207,7 +205,7 @@ Requires-Dist: setuptools>=63.3.0; extra == "api"
 Requires-Dist: PyYAML>=5.3.1; extra == "api"
 Requires-Dist: pip>=22.0.4; extra == "api"
 Requires-Dist: update-checker>=0.18.0; extra == "api"
-Requires-Dist: semver>=3.0.0; extra == "api"
+Requires-Dist: semver>=3.0.2; extra == "api"
 Requires-Dist: pathspec>=0.9.0; extra == "api"
 Requires-Dist: python-dateutil>=2.7.5; extra == "api"
 Requires-Dist: requests>=2.32.3; extra == "api"
@@ -222,8 +220,7 @@ Requires-Dist: prompt-toolkit>=3.0.39; extra == "api"
 Requires-Dist: more-itertools>=8.7.0; extra == "api"
 Requires-Dist: fasteners>=0.19.0; extra == "api"
 Requires-Dist: virtualenv>=20.1.0; extra == "api"
-Requires-Dist: attrs<24.2.0; extra == "api"
-Requires-Dist: APScheduler>=4.0.0a5; extra == "api"
+Requires-Dist: attrs>=24.2.0; extra == "api"
 Requires-Dist: uv>=0.2.11; extra == "api"
 Requires-Dist: pprintpp>=0.4.0; extra == "api"
 Requires-Dist: asciitree>=0.3.3; extra == "api"
@@ -259,7 +256,7 @@ Requires-Dist: setuptools>=63.3.0; extra == "full"
 Requires-Dist: PyYAML>=5.3.1; extra == "full"
 Requires-Dist: pip>=22.0.4; extra == "full"
 Requires-Dist: update-checker>=0.18.0; extra == "full"
-Requires-Dist: semver>=3.0.0; extra == "full"
+Requires-Dist: semver>=3.0.2; extra == "full"
 Requires-Dist: pathspec>=0.9.0; extra == "full"
 Requires-Dist: python-dateutil>=2.7.5; extra == "full"
 Requires-Dist: requests>=2.32.3; extra == "full"
@@ -274,8 +271,7 @@ Requires-Dist: prompt-toolkit>=3.0.39; extra == "full"
 Requires-Dist: more-itertools>=8.7.0; extra == "full"
 Requires-Dist: fasteners>=0.19.0; extra == "full"
 Requires-Dist: virtualenv>=20.1.0; extra == "full"
-Requires-Dist: attrs<24.2.0; extra == "full"
-Requires-Dist: APScheduler>=4.0.0a5; extra == "full"
+Requires-Dist: attrs>=24.2.0; extra == "full"
 Requires-Dist: uv>=0.2.11; extra == "full"
 Requires-Dist: dill>=0.3.3; extra == "full"
 Requires-Dist: python-daemon>=0.2.3; extra == "full"

{meerschaum-2.4.13 → meerschaum-2.5.0}/meerschaum/actions/upgrade.py

@@ -109,6 +109,7 @@ def _upgrade_meerschaum(
 class NoVenv:
     pass
 
+
 def _upgrade_packages(
     action: Optional[List[str]] = None,
     venv: Union[str, None, NoVenv] = NoVenv,
@@ -121,7 +122,7 @@ def _upgrade_packages(
     """
     Upgrade and install dependencies.
     If provided, upgrade only a dependency group, otherwise default to `full`.
-    
+
     Examples:
         upgrade packages
         upgrade packages full
@@ -160,7 +161,7 @@ def _upgrade_packages(
     to_install = [
         install_name
         for install_name in to_install
-        if install_name not in prereleases_to_install
+        if (install_name not in prereleases_to_install) or group == '_internal'
     ]
 
     success, msg = False, f"Nothing installed."

{meerschaum-2.4.13 → meerschaum-2.5.0}/meerschaum/config/_version.py

@@ -2,4 +2,4 @@
 Specify the Meerschaum release version.
 """
 
-__version__ = "2.4.13"
+__version__ = "2.5.0"

{meerschaum-2.4.13 → meerschaum-2.5.0}/meerschaum/connectors/sql/_create_engine.py

@@ -63,6 +63,8 @@ flavor_configs = {
             'fast_executemany': True,
             'isolation_level': 'AUTOCOMMIT',
             'use_setinputsizes': False,
+            'pool_pre_ping': True,
+            'ignore_no_transaction_on_rollback': True,
         },
         'omit_create_engine': {'method',},
         'to_sql': {
@@ -189,15 +191,18 @@ def create_engine(
     ### Install and patch required drivers.
     if self.flavor in install_flavor_drivers:
         attempt_import(*install_flavor_drivers[self.flavor], debug=debug, lazy=False, warn=False)
+        if self.flavor == 'mssql':
+            pyodbc = attempt_import('pyodbc', debug=debug, lazy=False, warn=False)
+            pyodbc.pooling = False
     if self.flavor in require_patching_flavors:
         from meerschaum.utils.packages import determine_version, _monkey_patch_get_distribution
         import pathlib
         for install_name, import_name in require_patching_flavors[self.flavor]:
             pkg = attempt_import(
                 import_name,
-                debug = debug,
-                lazy = False,
-                warn = False
+                debug=debug,
+                lazy=False,
+                warn=False
             )
             _monkey_patch_get_distribution(
                 install_name, determine_version(pathlib.Path(pkg.__file__), venv='mrsm')

{meerschaum-2.4.13 → meerschaum-2.5.0}/meerschaum/connectors/sql/_fetch.py

@@ -31,7 +31,7 @@ def fetch(
     ----------
     pipe: mrsm.Pipe
         The pipe object which contains the `fetch` metadata.
-        
+
         - pipe.columns['datetime']: str
             - Name of the datetime column for the remote table.
         - pipe.parameters['fetch']: Dict[str, Any]
@@ -196,7 +196,7 @@ def get_pipe_metadef(
             dateadd_str(
                 flavor=self.flavor,
                 datepart='minute',
-                number=((-1 * btm) if apply_backtrack else 0), 
+                number=((-1 * btm) if apply_backtrack else 0),
                 begin=begin,
             )
             if begin

{meerschaum-2.4.13 → meerschaum-2.5.0}/meerschaum/connectors/sql/_instance.py

@@ -88,9 +88,9 @@ def _drop_temporary_tables(self, debug: bool = False) -> SuccessTuple:
     from meerschaum.connectors.sql.tables import get_tables
     sqlalchemy = mrsm.attempt_import('sqlalchemy')
     temp_tables_table = get_tables(
-        mrsm_instance = self,
-        create = False,
-        debug = debug,
+        mrsm_instance=self,
+        create=False,
+        debug=debug,
     )['temp_tables']
     query = (
         sqlalchemy.select(temp_tables_table.c.table)

{meerschaum-2.4.13 → meerschaum-2.5.0}/meerschaum/connectors/sql/_pipes.py

@@ -384,7 +384,7 @@ def get_create_index_queries(
 
     Returns
     -------
-    A dictionary of column names mapping to lists of queries.
+    A dictionary of index names mapping to lists of queries.
     """
     ### NOTE: Due to recent breaking changes in DuckDB, indices don't behave properly.
     if self.flavor == 'duckdb':
@@ -400,7 +400,8 @@ def get_create_index_queries(
     index_queries = {}
 
     upsert = pipe.parameters.get('upsert', False) and (self.flavor + '-upsert') in update_queries
-    indices = pipe.get_indices()
+    index_names = pipe.get_indices()
+    indices = pipe.indices
 
     _datetime = pipe.get_columns('datetime', error=False)
     _datetime_type = pipe.dtypes.get(_datetime, 'datetime64[ns]')
@@ -409,8 +410,8 @@ def get_create_index_queries(
         if _datetime is not None else None
     )
     _datetime_index_name = (
-        sql_item_name(indices['datetime'], self.flavor, None)
-        if indices.get('datetime', None)
+        sql_item_name(index_names['datetime'], self.flavor, None)
+        if index_names.get('datetime', None)
         else None
     )
     _id = pipe.get_columns('id', error=False)
@@ -421,8 +422,8 @@ def get_create_index_queries(
     )
 
     _id_index_name = (
-        sql_item_name(indices['id'], self.flavor, None)
-        if indices.get('id', None)
+        sql_item_name(index_names['id'], self.flavor, None)
+        if index_names.get('id', None)
         else None
     )
     _pipe_name = sql_item_name(pipe.target, self.flavor, self.get_pipe_schema(pipe))
@@ -491,18 +492,22 @@ def get_create_index_queries(
         if id_query is not None:
             index_queries[_id] = id_query if isinstance(id_query, list) else [id_query]
 
-
     ### Create indices for other labels in `pipe.columns`.
-    other_indices = {
+    other_index_names = {
         ix_key: ix_unquoted
-        for ix_key, ix_unquoted in pipe.get_indices().items()
+        for ix_key, ix_unquoted in index_names.items()
         if ix_key not in ('datetime', 'id')
     }
-    for ix_key, ix_unquoted in other_indices.items():
+    for ix_key, ix_unquoted in other_index_names.items():
         ix_name = sql_item_name(ix_unquoted, self.flavor, None)
-        col = pipe.columns[ix_key]
-        col_name = sql_item_name(col, self.flavor, None)
-        index_queries[col] = [f"CREATE INDEX {ix_name} ON {_pipe_name} ({col_name})"]
+        cols = indices[ix_key]
+        if not isinstance(cols, (list, tuple)):
+            cols = [cols]
+        cols_names = [sql_item_name(col, self.flavor, None) for col in cols if col]
+        if not cols_names:
+            continue
+        cols_names_str = ", ".join(cols_names)
+        index_queries[ix_key] = [f"CREATE INDEX {ix_name} ON {_pipe_name} ({cols_names_str})"]
 
     existing_cols_types = pipe.get_columns_types(debug=debug)
     indices_cols_str = ', '.join(

{meerschaum-2.4.13 → meerschaum-2.5.0}/meerschaum/connectors/sql/_sql.py

@@ -17,8 +17,9 @@ from meerschaum.utils.warnings import warn
 ### database flavors that can use bulk insert
 _bulk_flavors = {'postgresql', 'timescaledb', 'citus'}
 ### flavors that do not support chunks
-_disallow_chunks_flavors = {'duckdb', 'mssql'}
+_disallow_chunks_flavors = ['duckdb']
 _max_chunks_flavors = {'sqlite': 1000,}
+SKIP_READ_TRANSACTION_FLAVORS: list[str] = ['mssql']
 
 
 def read(
@@ -97,7 +98,7 @@ def read(
         Defaults to `SQLConnector.schema`.
 
     as_chunks: bool, default False
-        If `True`, return a list of DataFrames. 
+        If `True`, return a list of DataFrames.
         Otherwise return a single DataFrame.
 
     as_iterator: bool, default False
@@ -127,7 +128,6 @@ def read(
     from meerschaum.utils.pool import get_pool
     from meerschaum.utils.dataframe import chunksize_to_npartitions, get_numeric_cols
     import warnings
-    import inspect
     import traceback
     from decimal import Decimal
     pd = import_pandas()
@@ -140,6 +140,7 @@ def read(
         chunksize = None
     schema = schema or self.schema
 
+    pool = get_pool(workers=workers)
     sqlalchemy = attempt_import("sqlalchemy")
     default_chunksize = self._sys_config.get('chunksize', None)
     chunksize = chunksize if chunksize != -1 else default_chunksize
@@ -157,7 +158,7 @@ def read(
                     f"The specified chunksize of {chunksize} exceeds the maximum of "
                     + f"{_max_chunks_flavors[self.flavor]} for flavor '{self.flavor}'.\n"
                     + f"    Falling back to a chunksize of {_max_chunks_flavors[self.flavor]}.",
-                    stacklevel = 3,
+                    stacklevel=3,
                 )
             chunksize = _max_chunks_flavors[self.flavor]
 
@@ -184,8 +185,8 @@ def read(
         truncated_table_name = truncate_item_name(str(query_or_table), self.flavor)
         if truncated_table_name != str(query_or_table) and not silent:
             warn(
-                f"Table '{name}' is too long for '{self.flavor}',"
-                + f" will instead create the table '{truncated_name}'."
+                f"Table '{query_or_table}' is too long for '{self.flavor}',"
+                + f" will instead read the table '{truncated_table_name}'."
             )
 
         query_or_table = sql_item_name(str(query_or_table), self.flavor, schema)
@@ -204,6 +205,34 @@ def read(
 
     chunk_list = []
     chunk_hook_results = []
+    def _process_chunk(_chunk, _retry_on_failure: bool = True):
+        if not as_hook_results:
+            chunk_list.append(_chunk)
+        if chunk_hook is None:
+            return None
+
+        result = None
+        try:
+            result = chunk_hook(
+                _chunk,
+                workers=workers,
+                chunksize=chunksize,
+                debug=debug,
+                **kw
+            )
+        except Exception:
+            result = False, traceback.format_exc()
+            from meerschaum.utils.formatting import get_console
+            if not silent:
+                get_console().print_exception()
+
+        ### If the chunk fails to process, try it again one more time.
+        if isinstance(result, tuple) and result[0] is False:
+            if _retry_on_failure:
+                return _process_chunk(_chunk, _retry_on_failure=False)
+
+        return result
+
     try:
         stream_results = not as_iterator and chunk_hook is not None and chunksize is not None
         with warnings.catch_warnings():
@@ -235,52 +264,32 @@ def read(
                 )
             else:
 
-                with self.engine.begin() as transaction:
-                    with transaction.execution_options(stream_results=stream_results) as connection:
-                        chunk_generator = pd.read_sql_query(
-                            formatted_query,
-                            connection,
-                            **read_sql_query_kwargs
+                def get_chunk_generator(connectable):
+                    chunk_generator = pd.read_sql_query(
+                        formatted_query,
+                        self.engine,
+                        **read_sql_query_kwargs
+                    )
+                    to_return = (
+                        chunk_generator
+                        if as_iterator or chunksize is None
+                        else (
+                            list(pool.imap(_process_chunk, chunk_generator))
+                            if as_hook_results
+                            else None
                         )
+                    )
+                    return chunk_generator, to_return
+
+                if self.flavor in SKIP_READ_TRANSACTION_FLAVORS:
+                    chunk_generator, to_return = get_chunk_generator(self.engine)
+                else:
+                    with self.engine.begin() as transaction:
+                        with transaction.execution_options(stream_results=stream_results) as connection:
+                            chunk_generator, to_return = get_chunk_generator(connection)
 
-                        ### `stream_results` must be False (will load everything into memory).
-                        if as_iterator or chunksize is None:
-                            return chunk_generator
-
-                        ### We must consume the generator in this context if using server-side cursors.
-                        if stream_results:
-
-                            pool = get_pool(workers=workers)
-
-                            def _process_chunk(_chunk, _retry_on_failure: bool = True):
-                                if not as_hook_results:
-                                    chunk_list.append(_chunk)
-                                result = None
-                                if chunk_hook is not None:
-                                    try:
-                                        result = chunk_hook(
-                                            _chunk,
-                                            workers = workers,
-                                            chunksize = chunksize,
-                                            debug = debug,
-                                            **kw
-                                        )
-                                    except Exception as e:
-                                        result = False, traceback.format_exc()
-                                        from meerschaum.utils.formatting import get_console
-                                        if not silent:
-                                            get_console().print_exception()
-
-                                    ### If the chunk fails to process, try it again one more time.
-                                    if isinstance(result, tuple) and result[0] is False:
-                                        if _retry_on_failure:
-                                            return _process_chunk(_chunk, _retry_on_failure=False)
-
-                                return result
-
-                            chunk_hook_results = list(pool.imap(_process_chunk, chunk_generator))
-                            if as_hook_results:
-                                return chunk_hook_results
+                if to_return is not None:
+                    return to_return
 
     except Exception as e:
         if debug:

{meerschaum-2.4.13 → meerschaum-2.5.0}/meerschaum/core/Pipe/__init__.py

@@ -98,6 +98,8 @@ class Pipe:
         attributes,
         parameters,
         columns,
+        indices,
+        indexes,
         dtypes,
         get_columns,
         get_columns_types,
@@ -145,6 +147,7 @@ class Pipe:
         location: Optional[str] = None,
         parameters: Optional[Dict[str, Any]] = None,
         columns: Union[Dict[str, str], List[str], None] = None,
+        indices: Optional[Dict[str, Union[str, List[str]]]] = None,
         tags: Optional[List[str]] = None,
         target: Optional[str] = None,
         dtypes: Optional[Dict[str, str]] = None,
@@ -156,6 +159,7 @@ class Pipe:
         connector_keys: Optional[str] = None,
         metric_key: Optional[str] = None,
         location_key: Optional[str] = None,
+        indexes: Union[Dict[str, str], List[str], None] = None,
     ):
         """
         Parameters
@@ -174,10 +178,14 @@ class Pipe:
             e.g. columns and other attributes.
             You can edit these parameters with `edit pipes`.
 
-        columns: Optional[Dict[str, str]], default None
+        columns: Union[Dict[str, str], List[str], None], default None
             Set the `columns` dictionary of `parameters`.
             If `parameters` is also provided, this dictionary is added under the `'columns'` key.
 
+        indices: Optional[Dict[str, Union[str, List[str]]]], default None
+            Set the `indices` dictionary of `parameters`.
+            If `parameters` is also provided, this dictionary is added under the `'indices'` key.
+
         tags: Optional[List[str]], default None
             A list of strings to be added under the `'tags'` key of `parameters`.
             You can select pipes with certain tags using `--tags`.
@@ -255,6 +263,20 @@ class Pipe:
         elif columns is not None:
             warn(f"The provided columns are of invalid type '{type(columns)}'.")
 
+        indices = (
+            indices
+            or indexes
+            or self._attributes.get('parameters', {}).get('indices', None)
+            or self._attributes.get('parameters', {}).get('indexes', None)
+        ) or columns
+        if isinstance(indices, dict):
+            indices_key = (
+                'indexes'
+                if 'indexes' in self._attributes['parameters']
+                else 'indices'
+            )
+            self._attributes['parameters'][indices_key] = indices
+
         if isinstance(tags, (list, tuple)):
             self._attributes['parameters']['tags'] = tags
         elif tags is not None:

{meerschaum-2.4.13 → meerschaum-2.5.0}/meerschaum/core/Pipe/_attributes.py

@@ -77,15 +77,69 @@ def columns(self) -> Union[Dict[str, str], None]:
 
 
 @columns.setter
-def columns(self, columns: Dict[str, str]) -> None:
+def columns(self, _columns: Union[Dict[str, str], List[str]]) -> None:
     """
     Override the columns dictionary of the in-memory pipe.
     Call `meerschaum.Pipe.edit()` to persist changes.
     """
+    if isinstance(_columns, (list, tuple)):
+        _columns = {col: col for col in _columns}
     if not isinstance(columns, dict):
-        warn(f"{self}.columns must be a dictionary, received {type(columns)}")
+        warn(f"{self}.columns must be a dictionary, received {type(_columns)}.")
         return
-    self.parameters['columns'] = columns
+    self.parameters['columns'] = _columns
+
+
+@property
+def indices(self) -> Union[Dict[str, Union[str, List[str]]], None]:
+    """
+    Return the `indices` dictionary defined in `meerschaum.Pipe.parameters`.
+    """
+    indices_key = (
+        'indexes'
+        if 'indexes' in self.parameters
+        else 'indices'
+    )
+    if indices_key not in self.parameters:
+        self.parameters[indices_key] = {}
+    _indices = self.parameters[indices_key]
+    if not isinstance(_indices, dict):
+        _indices = {}
+        self.parameters[indices_key] = _indices
+    return {**self.columns, **_indices}
+
+
+@property
+def indexes(self) -> Union[Dict[str, Union[str, List[str]]], None]:
+    """
+    Alias for `meerschaum.Pipe.indices`.
+    """
+    return self.indices
+
+
+@indices.setter
+def indices(self, _indices: Union[Dict[str, Union[str, List[str]]], List[str]]) -> None:
+    """
+    Override the indices dictionary of the in-memory pipe.
+    Call `meerschaum.Pipe.edit()` to persist changes.
+    """
+    if not isinstance(_indices, dict):
+        warn(f"{self}.indices must be a dictionary, received {type(_indices)}.")
+        return
+    indices_key = (
+        'indexes'
+        if 'indexes' in self.parameters
+        else 'indices'
+    )
+    self.parameters[indices_key] = _indices
+
+
+@indexes.setter
+def indexes(self, _indexes: Union[Dict[str, Union[str, List[str]]], List[str]]) -> None:
+    """
+    Alias for `meerschaum.Pipe.indices`.
+    """
+    self.indices = _indexes
 
 
 @property
@@ -415,27 +469,55 @@ def guess_datetime(self) -> Union[str, None]:
     """
     Try to determine a pipe's datetime column.
     """
-    dtypes = self.dtypes
+    _dtypes = self.dtypes
 
     ### Abort if the user explictly disallows a datetime index.
-    if 'datetime' in dtypes:
-        if dtypes['datetime'] is None:
+    if 'datetime' in _dtypes:
+        if _dtypes['datetime'] is None:
             return None
 
+    from meerschaum.utils.dtypes import are_dtypes_equal
     dt_cols = [
-        col for col, typ in self.dtypes.items()
-        if str(typ).startswith('datetime')
+        col
+        for col, typ in _dtypes.items()
+        if are_dtypes_equal(typ, 'datetime')
     ]
     if not dt_cols:
         return None
-    return dt_cols[0]    
+    return dt_cols[0]
 
 
 def get_indices(self) -> Dict[str, str]:
     """
-    Return a dictionary in the form of `pipe.columns` but map to index names.
-    """
-    return {
-        ix: (self.target + '_' + col + '_index')
-        for ix, col in self.columns.items() if col
+    Return a dictionary mapping index keys to their names on the database.
+
+    Returns
+    -------
+    A dictionary of index keys to column names.
+    """
+    _parameters = self.parameters
+    _index_template = _parameters.get('index_template', "IX_{target}_{column_names}")
+    _indices = self.indices
+    _target = self.target
+    _column_names = {
+        ix: (
+            '_'.join(cols)
+            if isinstance(cols, (list, tuple))
+            else str(cols)
+        )
+        for ix, cols in _indices.items()
+        if cols
+    }
+    _index_names = {
+        ix: (
+            _index_template.format(
+                target=_target,
+                column_names=column_names,
+                connector_keys=self.connector_keys,
+                metric_key=self.connector_key,
+                location_key=self.location_key,
+            )
+        )
+        for ix, column_names in _column_names.items()
     }
+    return _index_names