Function _column__create_index

tables/table.py:267–372

(
    self: Column,
    optlevel: int,
    kind: str,
    filters: Filters | None,
    tmp_dir: str,
    blocksizes: tuple[int, int, int, int],
    verbose: bool,
)

def _column__create_index(
    self: Column,
    optlevel: int,
    kind: str,
    filters: Filters | None,
    tmp_dir: str,
    blocksizes: tuple[int, int, int, int],
    verbose: bool,
) -> int:
    name = self.name
    table = self.table
    dtype = self.dtype
    descr = self.descr
    index = self.index
    get_node = table._v_file._get_node

    # Warn if the index already exists
    if index:
        raise ValueError(
            "%s for column '%s' already exists. If you want to "
            "re-create it, please, try with reindex() method "
            "better" % (str(index), str(self.pathname))
        )

    # Check that the datatype is indexable.
    if dtype.str[1:] == "u8":
        raise NotImplementedError(
            "indexing 64-bit unsigned integer columns "
            "is not supported yet, sorry"
        )
    if dtype.kind == "c":
        raise TypeError("complex columns can not be indexed")
    if dtype.shape != ():
        raise TypeError("multidimensional columns can not be indexed")

    # Get the indexes group for table, and if not exists, create it
    try:
        itgroup = get_node(_index_pathname_of(table))
    except NoSuchNodeError:
        itgroup = create_indexes_table(table)

    # Create the necessary intermediate groups for descriptors
    idgroup = itgroup
    dname = ""
    pathname = descr._v_pathname
    if pathname != "":
        inames = pathname.split("/")
        for iname in inames:
            if dname == "":
                dname = iname
            else:
                dname += "/" + iname
            try:
                idgroup = get_node(f"{itgroup._v_pathname}/{dname}")
            except NoSuchNodeError:
                idgroup = create_indexes_descr(idgroup, dname, iname, filters)

    # Create the atom