Page History

/**
 * Catalog service provides methods to access schema object's descriptors of exact version and/or last actual version at given timestamp,
 * which is logical point-in-time.
 *
 * <p>Catalog service listens distributed schema update event, stores/restores schema evolution history (schema versions) for time-travelled
 * queries purposes and for lazy data evolution purposes.
 */
public interface CatalogService extends EventProducer<CatalogEvent, CatalogEventParameters> {
    @Nullable Catalog catalog(int catalogVersion);

    @Nullable CatalogTableDescriptor table(String tableName, long timestamp);

    @Nullable CatalogTableDescriptor table(int tableId, long timestamp);

    @Nullable CatalogTab
leDescriptorCatalogTableDescriptor table(int tableId, int catalogVersion);

    Collection<CatalogTableDescriptor> tables(int catalogVersion);

    // rest of the access methods
}

public class CatalogTableDescriptor extends CatalogObjectDescriptor {
    // private properties and constructors

    /**
     * 
Returns an identifier of a schema this table descriptor belongs to.
     */
    public int schemaId() {...}

    /**
     * Returns versions of this table descriptor.
     */
    public CatalogTableSchemaVersions schemaVersions() {...}

    /**
     * Returns an identifier of a distribution zone this table descriptor belongs to.
     */
    public int zoneId() {...}

    /**
     * Returns a identifier of the primary key index.
     */
    public int primaryKeyIndexId() {...}

    /**
     * Returns a version of this table descriptor.
     */
    public int tableVersion() {...}

    /**
     * Returns a list primary key column names.
     */
    public List<String> primaryKeyColumns() {...}

    /**
     * Returns a list colocation key column names.
     */
    public List<String> colocationColumns() {...}

    /**
     * Returns a list column descriptors for the table.
     */
    public List<CatalogTableColumnDescriptor> columns() {...}

    /** Returns a column descriptor for column with given name, {@code null} if absent. */
    public @Nullable CatalogTableColumnDescriptor column(String name) {...}

    /**
     * Returns an index of a column with the given name, or {@code -1} if such column does not exist.
     */
    public int columnIndex(String name) {...}

    /**
     * Returns {@code true} if this the given column is a part of the primary key.
     */
    public boolean isPrimaryKeyColumn(String name) {...}

    /**
     * Returns {@code true} if this the given column is a part of collocation key.
     */
    public boolean isColocationColumn(String name) {...}

    /**
     * Returns a name of a storage profile.
     */
    public String storageProfile() {...}
}