Please wait. This can take some minutes ...
Many resources are needed to download a project. Please understand that we have to compensate our server costs. Thank you in advance.
Project price only 1 $
You can buy this project and download/modify it how often you want.
io.trino.plugin.tpch.TpchMetadata Maven / Gradle / Ivy
/*
* Licensed under the Apache License, Version 2.0 (the "License");
* you may not use this file except in compliance with the License.
* You may obtain a copy of the License at
*
* http://www.apache.org/licenses/LICENSE-2.0
*
* Unless required by applicable law or agreed to in writing, software
* distributed under the License is distributed on an "AS IS" BASIS,
* WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
* See the License for the specific language governing permissions and
* limitations under the License.
*/
package io.trino.plugin.tpch;
import com.fasterxml.jackson.databind.ObjectMapper;
import com.fasterxml.jackson.datatype.jdk8.Jdk8Module;
import com.google.common.annotations.VisibleForTesting;
import com.google.common.collect.ImmutableBiMap;
import com.google.common.collect.ImmutableList;
import com.google.common.collect.ImmutableMap;
import com.google.common.collect.ImmutableSet;
import io.airlift.slice.Slice;
import io.airlift.slice.Slices;
import io.trino.plugin.tpch.statistics.ColumnStatisticsData;
import io.trino.plugin.tpch.statistics.StatisticsEstimator;
import io.trino.plugin.tpch.statistics.TableStatisticsData;
import io.trino.plugin.tpch.statistics.TableStatisticsDataRepository;
import io.trino.spi.TrinoException;
import io.trino.spi.connector.CatalogSchemaTableName;
import io.trino.spi.connector.ColumnHandle;
import io.trino.spi.connector.ColumnMetadata;
import io.trino.spi.connector.ConnectorAnalyzeMetadata;
import io.trino.spi.connector.ConnectorMetadata;
import io.trino.spi.connector.ConnectorSession;
import io.trino.spi.connector.ConnectorTableHandle;
import io.trino.spi.connector.ConnectorTableLayout;
import io.trino.spi.connector.ConnectorTableMetadata;
import io.trino.spi.connector.ConnectorTablePartitioning;
import io.trino.spi.connector.ConnectorTableProperties;
import io.trino.spi.connector.ConnectorTableVersion;
import io.trino.spi.connector.Constraint;
import io.trino.spi.connector.ConstraintApplicationResult;
import io.trino.spi.connector.LocalProperty;
import io.trino.spi.connector.SchemaTableName;
import io.trino.spi.connector.SchemaTablePrefix;
import io.trino.spi.connector.SortOrder;
import io.trino.spi.connector.SortingProperty;
import io.trino.spi.connector.TableScanRedirectApplicationResult;
import io.trino.spi.predicate.Domain;
import io.trino.spi.predicate.NullableValue;
import io.trino.spi.predicate.TupleDomain;
import io.trino.spi.statistics.ColumnStatistics;
import io.trino.spi.statistics.ComputedStatistics;
import io.trino.spi.statistics.DoubleRange;
import io.trino.spi.statistics.Estimate;
import io.trino.spi.statistics.TableStatistics;
import io.trino.spi.statistics.TableStatisticsMetadata;
import io.trino.spi.type.DecimalType;
import io.trino.spi.type.Type;
import io.trino.spi.type.VarcharType;
import io.trino.tpch.Distributions;
import io.trino.tpch.LineItemColumn;
import io.trino.tpch.OrderColumn;
import io.trino.tpch.OrderGenerator;
import io.trino.tpch.PartColumn;
import io.trino.tpch.TpchColumn;
import io.trino.tpch.TpchColumnType;
import io.trino.tpch.TpchEntity;
import io.trino.tpch.TpchTable;
import java.time.LocalDate;
import java.util.Collection;
import java.util.List;
import java.util.Map;
import java.util.Optional;
import java.util.Set;
import java.util.stream.Collectors;
import static com.google.common.base.Preconditions.checkArgument;
import static com.google.common.collect.ImmutableSet.toImmutableSet;
import static com.google.common.collect.Maps.asMap;
import static io.trino.plugin.tpch.util.PredicateUtils.convertToPredicate;
import static io.trino.plugin.tpch.util.PredicateUtils.filterOutColumnFromPredicate;
import static io.trino.spi.StandardErrorCode.NOT_SUPPORTED;
import static io.trino.spi.statistics.TableStatisticType.ROW_COUNT;
import static io.trino.spi.type.BigintType.BIGINT;
import static io.trino.spi.type.DateType.DATE;
import static io.trino.spi.type.DoubleType.DOUBLE;
import static io.trino.spi.type.IntegerType.INTEGER;
import static io.trino.spi.type.VarcharType.createVarcharType;
import static java.lang.String.format;
import static java.util.Collections.emptyList;
import static java.util.Collections.emptyMap;
import static java.util.Objects.requireNonNull;
import static java.util.stream.Collectors.toList;
import static java.util.stream.Collectors.toSet;
public class TpchMetadata
implements ConnectorMetadata
{
public static final String TINY_SCHEMA_NAME = "tiny";
public static final double TINY_SCALE_FACTOR = 0.01;
public static final List SCHEMA_NAMES = ImmutableList.of(
TINY_SCHEMA_NAME, "sf1", "sf100", "sf300", "sf1000", "sf3000", "sf10000", "sf30000", "sf100000");
public static final String ROW_NUMBER_COLUMN_NAME = "row_number";
private static final Set ORDER_STATUS_VALUES = ImmutableSet.of("F", "O", "P").stream()
.map(Slices::utf8Slice)
.collect(toImmutableSet());
private static final Set PART_TYPE_VALUES = Distributions.getDefaultDistributions().getPartTypes().getValues().stream()
.map(Slices::utf8Slice)
.collect(toImmutableSet());
private static final Set PART_CONTAINER_VALUES = Distributions.getDefaultDistributions().getPartContainers().getValues().stream()
.map(Slices::utf8Slice)
.collect(toImmutableSet());
private final Set tableNames;
private final ColumnNaming columnNaming;
private final DecimalTypeMapping decimalTypeMapping;
private final StatisticsEstimator statisticsEstimator;
private final boolean predicatePushdownEnabled;
private final boolean partitioningEnabled;
private final Optional destinationCatalog;
private final Optional destinationSchema;
private final Set orderStatusNullableValues;
private final Set partTypeNullableValues;
private final Set partContainerNullableValues;
public TpchMetadata()
{
this(ColumnNaming.SIMPLIFIED, DecimalTypeMapping.DOUBLE, true, true, Optional.empty(), Optional.empty());
}
public TpchMetadata(
ColumnNaming columnNaming,
DecimalTypeMapping decimalTypeMapping,
boolean predicatePushdownEnabled,
boolean partitioningEnabled,
Optional destinationCatalog,
Optional destinationSchema)
{
ImmutableSet.Builder tableNames = ImmutableSet.builder();
for (TpchTable> tpchTable : TpchTable.getTables()) {
tableNames.add(tpchTable.getTableName());
}
this.tableNames = tableNames.build();
this.columnNaming = columnNaming;
this.decimalTypeMapping = decimalTypeMapping;
this.predicatePushdownEnabled = predicatePushdownEnabled;
this.partitioningEnabled = partitioningEnabled;
this.statisticsEstimator = createStatisticsEstimator();
this.destinationCatalog = destinationCatalog;
this.destinationSchema = destinationSchema;
partContainerNullableValues = PART_CONTAINER_VALUES.stream()
.map(value -> new NullableValue(getTrinoType(PartColumn.CONTAINER, decimalTypeMapping), value))
.collect(toSet());
partTypeNullableValues = PART_TYPE_VALUES.stream()
.map(value -> new NullableValue(getTrinoType(PartColumn.TYPE, decimalTypeMapping), value))
.collect(toSet());
orderStatusNullableValues = ORDER_STATUS_VALUES.stream()
.map(value -> new NullableValue(getTrinoType(OrderColumn.ORDER_STATUS, decimalTypeMapping), value))
.collect(toSet());
}
private static StatisticsEstimator createStatisticsEstimator()
{
ObjectMapper objectMapper = new ObjectMapper()
.registerModule(new Jdk8Module());
TableStatisticsDataRepository tableStatisticsDataRepository = new TableStatisticsDataRepository(objectMapper);
return new StatisticsEstimator(tableStatisticsDataRepository);
}
@Override
public boolean schemaExists(ConnectorSession session, String schemaName)
{
return schemaNameToScaleFactor(schemaName) > 0;
}
@Override
public List listSchemaNames(ConnectorSession session)
{
return SCHEMA_NAMES;
}
@Override
public TpchTableHandle getTableHandle(ConnectorSession session, SchemaTableName tableName, Optional startVersion, Optional endVersion)
{
if (startVersion.isPresent() || endVersion.isPresent()) {
throw new TrinoException(NOT_SUPPORTED, "This connector does not support versioned tables");
}
requireNonNull(tableName, "tableName is null");
if (!tableNames.contains(tableName.getTableName())) {
return null;
}
// parse the scale factor
double scaleFactor = schemaNameToScaleFactor(tableName.getSchemaName());
if (scaleFactor <= 0) {
return null;
}
return new TpchTableHandle(tableName.getSchemaName(), tableName.getTableName(), scaleFactor);
}
private Set filterValues(Set nullableValues, TpchColumn> column, Constraint constraint)
{
return nullableValues.stream()
.filter(convertToPredicate(constraint.getSummary(), toColumnHandle(column)))
.filter(value -> constraint.predicate().isEmpty() || constraint.predicate().get().test(ImmutableMap.of(toColumnHandle(column), value)))
.collect(toSet());
}
@Override
public ConnectorTableMetadata getTableMetadata(ConnectorSession session, ConnectorTableHandle tableHandle)
{
TpchTableHandle tpchTableHandle = (TpchTableHandle) tableHandle;
TpchTable> tpchTable = TpchTable.getTable(tpchTableHandle.tableName());
return getTableMetadata(tpchTableHandle.schemaName(), tpchTable, columnNaming);
}
private ConnectorTableMetadata getTableMetadata(String schemaName, TpchTable> tpchTable, ColumnNaming columnNaming)
{
ImmutableList.Builder columns = ImmutableList.builder();
columns.add(ColumnMetadata.builder()
.setName(ROW_NUMBER_COLUMN_NAME)
.setType(BIGINT)
.setHidden(true)
.build());
for (TpchColumn extends TpchEntity> column : tpchTable.getColumns()) {
columns.add(ColumnMetadata.builder()
.setName(columnNaming.getName(column))
.setType(getTrinoType(column, decimalTypeMapping))
.setNullable(false)
.build());
}
SchemaTableName tableName = new SchemaTableName(schemaName, tpchTable.getTableName());
return new ConnectorTableMetadata(tableName, columns.build());
}
@Override
public Map getColumnHandles(ConnectorSession session, ConnectorTableHandle tableHandle)
{
ImmutableMap.Builder builder = ImmutableMap.builder();
for (ColumnMetadata columnMetadata : getTableMetadata(session, tableHandle).getColumns()) {
builder.put(columnMetadata.getName(), new TpchColumnHandle(columnMetadata.getName(), columnMetadata.getType()));
}
return builder.buildOrThrow();
}
@Override
public Map> listTableColumns(ConnectorSession session, SchemaTablePrefix prefix)
{
ImmutableMap.Builder> tableColumns = ImmutableMap.builder();
for (String schemaName : getSchemaNames(session, prefix.getSchema())) {
for (TpchTable> tpchTable : TpchTable.getTables()) {
if (prefix.getTable().map(tpchTable.getTableName()::equals).orElse(true)) {
ConnectorTableMetadata tableMetadata = getTableMetadata(schemaName, tpchTable, columnNaming);
tableColumns.put(new SchemaTableName(schemaName, tpchTable.getTableName()), tableMetadata.getColumns());
}
}
}
return tableColumns.buildOrThrow();
}
@Override
public TableStatistics getTableStatistics(ConnectorSession session, ConnectorTableHandle tableHandle)
{
TpchTableHandle tpchTableHandle = (TpchTableHandle) tableHandle;
String tableName = tpchTableHandle.tableName();
TpchTable> tpchTable = TpchTable.getTable(tableName);
Map, List> columnValuesRestrictions = ImmutableMap.of();
if (predicatePushdownEnabled) {
columnValuesRestrictions = getColumnValuesRestrictions(tpchTable, tpchTableHandle.constraint());
}
Optional optionalTableStatisticsData = statisticsEstimator.estimateStats(tpchTable, columnValuesRestrictions, tpchTableHandle.scaleFactor());
Map columnHandles = getColumnHandles(session, tpchTableHandle);
return optionalTableStatisticsData
.map(tableStatisticsData -> toTableStatistics(tableStatisticsData, tpchTableHandle, columnHandles))
.orElse(TableStatistics.empty());
}
private Map, List> getColumnValuesRestrictions(TpchTable> tpchTable, TupleDomain constraintSummary)
{
if (constraintSummary.isAll()) {
return emptyMap();
}
if (constraintSummary.isNone()) {
Set> columns = ImmutableSet.copyOf(tpchTable.getColumns());
return asMap(columns, key -> emptyList());
}
Map domains = constraintSummary.getDomains().orElseThrow();
Optional orderStatusDomain = Optional.ofNullable(domains.get(toColumnHandle(OrderColumn.ORDER_STATUS)));
Optional, List>> allowedColumnValues = orderStatusDomain.map(domain -> {
List allowedValues = ORDER_STATUS_VALUES.stream()
.filter(domain::includesNullableValue)
.collect(toList());
return avoidTrivialOrderStatusRestriction(allowedValues);
});
return allowedColumnValues.orElse(emptyMap());
}
private static Map, List> avoidTrivialOrderStatusRestriction(List allowedValues)
{
if (allowedValues.containsAll(ORDER_STATUS_VALUES)) {
return emptyMap();
}
return ImmutableMap.of(OrderColumn.ORDER_STATUS, allowedValues);
}
private TableStatistics toTableStatistics(TableStatisticsData tableStatisticsData, TpchTableHandle tpchTableHandle, Map columnHandles)
{
TableStatistics.Builder builder = TableStatistics.builder()
.setRowCount(Estimate.of(tableStatisticsData.rowCount()));
tableStatisticsData.columns().forEach((columnName, stats) -> {
TpchColumnHandle columnHandle = (TpchColumnHandle) getColumnHandle(tpchTableHandle, columnHandles, columnName);
builder.setColumnStatistics(columnHandle, toColumnStatistics(stats, columnHandle.type()));
});
return builder.build();
}
private ColumnHandle getColumnHandle(TpchTableHandle tpchTableHandle, Map columnHandles, String columnName)
{
TpchTable> table = TpchTable.getTable(tpchTableHandle.tableName());
return columnHandles.get(columnNaming.getName(table.getColumn(columnName)));
}
private static ColumnStatistics toColumnStatistics(ColumnStatisticsData stats, Type columnType)
{
return ColumnStatistics.builder()
.setNullsFraction(Estimate.zero())
.setDistinctValuesCount(stats.distinctValuesCount().map(Estimate::of).orElse(Estimate.unknown()))
.setDataSize(stats.dataSize().map(Estimate::of).orElse(Estimate.unknown()))
.setRange(toRange(stats.min(), stats.max(), columnType))
.build();
}
private static Optional toRange(Optional min, Optional max, Type columnType)
{
if (columnType instanceof VarcharType) {
return Optional.empty();
}
if (min.isEmpty() || max.isEmpty()) {
return Optional.empty();
}
return Optional.of(new DoubleRange(toDouble(min.get(), columnType), toDouble(max.get(), columnType)));
}
private static double toDouble(Object value, Type columnType)
{
if (value instanceof String && columnType.equals(DATE)) {
return LocalDate.parse((CharSequence) value).toEpochDay();
}
if (value instanceof Number) {
if (columnType.equals(BIGINT) || columnType.equals(INTEGER) || columnType.equals(DATE)) {
return ((Number) value).longValue();
}
if (columnType.equals(DOUBLE) || columnType instanceof DecimalType) {
return ((Number) value).doubleValue();
}
}
throw new IllegalArgumentException("unsupported column type " + columnType);
}
@Override
public ConnectorAnalyzeMetadata getStatisticsCollectionMetadata(ConnectorSession session, ConnectorTableHandle tableHandle, Map analyzeProperties)
{
return new ConnectorAnalyzeMetadata(tableHandle, new TableStatisticsMetadata(ImmutableSet.of(), ImmutableSet.of(ROW_COUNT), ImmutableList.of()));
}
@Override
public ConnectorTableHandle beginStatisticsCollection(ConnectorSession session, ConnectorTableHandle tableHandle)
{
checkArgument(tableHandle instanceof TpchTableHandle);
return tableHandle;
}
@Override
public void finishStatisticsCollection(ConnectorSession session, ConnectorTableHandle tableHandle, Collection computedStatistics)
{
// do nothing
}
@VisibleForTesting
TpchColumnHandle toColumnHandle(TpchColumn> column)
{
return new TpchColumnHandle(columnNaming.getName(column), getTrinoType(column, decimalTypeMapping));
}
@Override
public ColumnMetadata getColumnMetadata(ConnectorSession session, ConnectorTableHandle tableHandle, ColumnHandle columnHandle)
{
ConnectorTableMetadata tableMetadata = getTableMetadata(session, tableHandle);
String columnName = ((TpchColumnHandle) columnHandle).columnName();
for (ColumnMetadata column : tableMetadata.getColumns()) {
if (column.getName().equals(columnName)) {
return column;
}
}
throw new IllegalArgumentException(format("Table '%s' does not have column '%s'", tableMetadata.getTable(), columnName));
}
@Override
public List listTables(ConnectorSession session, Optional filterSchema)
{
ImmutableList.Builder builder = ImmutableList.builder();
for (String schemaName : getSchemaNames(session, filterSchema)) {
for (TpchTable> tpchTable : TpchTable.getTables()) {
builder.add(new SchemaTableName(schemaName, tpchTable.getTableName()));
}
}
return builder.build();
}
@Override
public ConnectorTableProperties getTableProperties(ConnectorSession session, ConnectorTableHandle table)
{
TpchTableHandle tableHandle = (TpchTableHandle) table;
Optional tablePartitioning = Optional.empty();
List> localProperties = ImmutableList.of();
Map columns = getColumnHandles(session, tableHandle);
if (partitioningEnabled && tableHandle.tableName().equals(TpchTable.ORDERS.getTableName())) {
ColumnHandle orderKeyColumn = columns.get(columnNaming.getName(OrderColumn.ORDER_KEY));
tablePartitioning = Optional.of(new ConnectorTablePartitioning(
new TpchPartitioningHandle(
TpchTable.ORDERS.getTableName(),
calculateTotalRows(OrderGenerator.SCALE_BASE, tableHandle.scaleFactor())),
ImmutableList.of(orderKeyColumn),
true));
localProperties = ImmutableList.of(new SortingProperty<>(orderKeyColumn, SortOrder.ASC_NULLS_FIRST));
}
else if (partitioningEnabled && tableHandle.tableName().equals(TpchTable.LINE_ITEM.getTableName())) {
ColumnHandle orderKeyColumn = columns.get(columnNaming.getName(LineItemColumn.ORDER_KEY));
tablePartitioning = Optional.of(new ConnectorTablePartitioning(
new TpchPartitioningHandle(
TpchTable.ORDERS.getTableName(),
calculateTotalRows(OrderGenerator.SCALE_BASE, tableHandle.scaleFactor())),
ImmutableList.of(orderKeyColumn),
true));
localProperties = ImmutableList.of(
new SortingProperty<>(orderKeyColumn, SortOrder.ASC_NULLS_FIRST),
new SortingProperty<>(columns.get(columnNaming.getName(LineItemColumn.LINE_NUMBER)), SortOrder.ASC_NULLS_FIRST));
}
TupleDomain constraint = tableHandle.constraint();
if (predicatePushdownEnabled && constraint.isAll()) {
if (tableHandle.tableName().equals(TpchTable.ORDERS.getTableName())) {
constraint = toTupleDomain(ImmutableMap.of(toColumnHandle(OrderColumn.ORDER_STATUS), orderStatusNullableValues));
}
else if (tableHandle.tableName().equals(TpchTable.PART.getTableName())) {
constraint = toTupleDomain(ImmutableMap.of(
toColumnHandle(PartColumn.CONTAINER),
partContainerNullableValues,
toColumnHandle(PartColumn.TYPE),
partTypeNullableValues));
}
}
return new ConnectorTableProperties(
constraint,
tablePartitioning,
Optional.empty(),
localProperties);
}
@Override
public Optional getInsertLayout(ConnectorSession session, ConnectorTableHandle tableHandle)
{
return Optional.empty();
}
@Override
public Optional> applyFilter(ConnectorSession session, ConnectorTableHandle table, Constraint constraint)
{
TpchTableHandle handle = (TpchTableHandle) table;
TupleDomain oldDomain = handle.constraint();
TupleDomain predicate = TupleDomain.all();
TupleDomain unenforcedConstraint = constraint.getSummary();
if (predicatePushdownEnabled && handle.tableName().equals(TpchTable.ORDERS.getTableName())) {
predicate = toTupleDomain(ImmutableMap.of(
toColumnHandle(OrderColumn.ORDER_STATUS),
filterValues(orderStatusNullableValues, OrderColumn.ORDER_STATUS, constraint)));
unenforcedConstraint = filterOutColumnFromPredicate(constraint.getSummary(), toColumnHandle(OrderColumn.ORDER_STATUS));
}
else if (predicatePushdownEnabled && handle.tableName().equals(TpchTable.PART.getTableName())) {
predicate = toTupleDomain(ImmutableMap.of(
toColumnHandle(PartColumn.CONTAINER),
filterValues(partContainerNullableValues, PartColumn.CONTAINER, constraint),
toColumnHandle(PartColumn.TYPE),
filterValues(partTypeNullableValues, PartColumn.TYPE, constraint)));
unenforcedConstraint = filterOutColumnFromPredicate(constraint.getSummary(), toColumnHandle(PartColumn.CONTAINER));
unenforcedConstraint = filterOutColumnFromPredicate(unenforcedConstraint, toColumnHandle(PartColumn.TYPE));
}
if (oldDomain.equals(predicate)) {
return Optional.empty();
}
return Optional.of(new ConstraintApplicationResult<>(
new TpchTableHandle(
handle.schemaName(),
handle.tableName(),
handle.scaleFactor(),
oldDomain.intersect(predicate)),
unenforcedConstraint,
constraint.getExpression(),
false));
}
@Override
public Optional applyTableScanRedirect(ConnectorSession session, ConnectorTableHandle table)
{
TpchTableHandle handle = (TpchTableHandle) table;
if (destinationCatalog.isEmpty()) {
return Optional.empty();
}
CatalogSchemaTableName destinationTable = new CatalogSchemaTableName(
destinationCatalog.get(),
destinationSchema.orElse(handle.schemaName()),
handle.tableName());
return Optional.of(
new TableScanRedirectApplicationResult(
destinationTable,
ImmutableBiMap.copyOf(getColumnHandles(session, table)).inverse(),
handle.constraint()
.transformKeys(TpchColumnHandle.class::cast)
.transformKeys(TpchColumnHandle::columnName)));
}
private static TupleDomain toTupleDomain(Map> predicate)
{
return TupleDomain.withColumnDomains(predicate.entrySet().stream()
.collect(Collectors.toMap(Map.Entry::getKey, entry -> {
Type type = entry.getKey().type();
return entry.getValue().stream()
.map(nullableValue -> Domain.singleValue(type, nullableValue.getValue()))
.reduce(Domain::union)
.orElseGet(() -> Domain.none(type));
})));
}
private List getSchemaNames(ConnectorSession session, Optional schemaName)
{
if (schemaName.isEmpty()) {
return listSchemaNames(session);
}
if (schemaNameToScaleFactor(schemaName.get()) > 0) {
return ImmutableList.of(schemaName.get());
}
return ImmutableList.of();
}
public static double schemaNameToScaleFactor(String schemaName)
{
if (TINY_SCHEMA_NAME.equals(schemaName)) {
return TINY_SCALE_FACTOR;
}
if (!schemaName.startsWith("sf")) {
return -1;
}
try {
return Double.parseDouble(schemaName.substring(2));
}
catch (Exception _) {
return -1;
}
}
public static Type getTrinoType(TpchColumn> column, DecimalTypeMapping decimalTypeMapping)
{
TpchColumnType tpchType = column.getType();
return switch (tpchType.getBase()) {
case IDENTIFIER -> BIGINT;
case INTEGER -> INTEGER;
case DATE -> DATE;
case DOUBLE -> decimalTypeMapping.getMappedType();
case VARCHAR -> createVarcharType((int) (long) tpchType.getPrecision().orElseThrow());
};
}
private static long calculateTotalRows(int scaleBase, double scaleFactor)
{
double totalRows = scaleBase * scaleFactor;
if (totalRows > Long.MAX_VALUE) {
throw new IllegalArgumentException("Total rows is larger than 2^64");
}
return (long) totalRows;
}
}