/**
 * Copyright (c) 2014 Baidu.com, Inc. All Rights Reserved
 *
 * 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.
 *
 * @file src/tsdb_data_client.ts
 * @author leeight
 */
import BceBaseClient from './bce_base_client';
import type { BceConfig, BceResponse } from './types/common';
/** TSDB Data 客户端选项 */
interface TsdbDataClientOptions {
    config?: Partial<BceConfig>;
}
/** 数据点 */
interface DataPoint {
    /** 指标名称 */
    metric: string;
    /** 标签 */
    tags?: Record<string, string>;
    /** 时间戳（毫秒） */
    timestamp: number;
    /** 数值 */
    value: number;
}
/** 写入选项 */
interface WriteOptions extends TsdbDataClientOptions {
    /** 数据库名称 */
    database: string;
    /** 是否等待写入完成 */
    waitForCompletion?: boolean;
}
/** 查询条件 */
interface QueryCondition {
    /** 指标名称 */
    metric: string;
    /** 标签过滤器 */
    tags?: Record<string, string | string[]>;
    /** 聚合函数 */
    aggregator?: 'sum' | 'avg' | 'max' | 'min' | 'count' | 'stddev';
    /** 分组标签 */
    groupBy?: string[];
    /** 下采样配置 */
    downsample?: {
        /** 时间间隔 */
        interval: string;
        /** 聚合函数 */
        aggregator: 'sum' | 'avg' | 'max' | 'min' | 'count';
    };
    /** 速率计算 */
    rate?: boolean;
}
/** 查询选项 */
interface QueryOptions extends TsdbDataClientOptions {
    /** 数据库名称 */
    database: string;
    /** 开始时间（Unix 时间戳，秒） */
    start: number;
    /** 结束时间（Unix 时间戳，秒） */
    end?: number;
    /** 查询条件列表 */
    queries: QueryCondition[];
    /** 时区 */
    timezone?: string;
    /** 是否显示详细信息 */
    showTSUIDs?: boolean;
}
/** 查询结果数据点 */
interface QueryResultDataPoint {
    /** 时间戳（毫秒） */
    timestamp: number;
    /** 数值 */
    value: number;
}
/** 查询结果 */
interface QueryResult {
    /** 指标名称 */
    metric: string;
    /** 标签 */
    tags: Record<string, string>;
    /** 聚合的标签 */
    aggregatedTags?: string[];
    /** 数据点 */
    dps: QueryResultDataPoint[];
    /** TSUID */
    tsuid?: string;
}
/** 删除选项 */
interface DeleteOptions extends TsdbDataClientOptions {
    /** 数据库名称 */
    database: string;
    /** 指标名称 */
    metric: string;
    /** 标签过滤器 */
    tags?: Record<string, string>;
    /** 开始时间（Unix 时间戳，秒） */
    start?: number;
    /** 结束时间（Unix 时间戳，秒） */
    end?: number;
}
/** 聚合查询选项 */
interface AggregateQueryOptions extends TsdbDataClientOptions {
    /** 数据库名称 */
    database: string;
    /** 指标名称 */
    metric: string;
    /** 标签过滤器 */
    tags?: Record<string, string>;
    /** 开始时间（Unix 时间戳，秒） */
    start: number;
    /** 结束时间（Unix 时间戳，秒） */
    end?: number;
    /** 聚合函数 */
    aggregator: 'sum' | 'avg' | 'max' | 'min' | 'count' | 'stddev';
    /** 时间间隔 */
    interval?: string;
}
/** 时间序列信息 */
interface TimeSeriesInfo {
    /** 时间序列唯一标识 */
    tsuid: string;
    /** 指标名称 */
    metric: string;
    /** 标签 */
    tags: Record<string, string>;
    /** 创建时间 */
    createTime: number;
    /** 最后写入时间 */
    lastWriteTime: number;
    /** 数据点数量 */
    dataPointCount: number;
}
/**
 * TSDB Data 时序数据库数据客户端
 */
export default class TsdbDataClient extends BceBaseClient {
    /**
     * 构造函数
     * @param config TSDB Data 客户端配置
     */
    constructor(config: BceConfig);
    /**
     * 写入单个数据点
     * @param datapoint 数据点
     * @param options 写入选项
     * @returns Promise 解析为写入结果
     */
    writeDatapoint(datapoint: DataPoint, options: WriteOptions): Promise<BceResponse<any>>;
    /**
     * 批量写入数据点
     * @param datapoints 数据点列表
     * @param options 写入选项
     * @returns Promise 解析为写入结果
     */
    writeDatapoints(datapoints: DataPoint[], options: WriteOptions): Promise<BceResponse<any>>;
    /**
     * 查询数据
     * @param options 查询选项
     * @returns Promise 解析为查询结果
     */
    queryData(options: QueryOptions): Promise<BceResponse<QueryResult[]>>;
    /**
     * 聚合查询
     * @param options 聚合查询选项
     * @returns Promise 解析为聚合结果
     */
    aggregateQuery(options: AggregateQueryOptions): Promise<BceResponse<any>>;
    /**
     * 获取最新数据点
     * @param database 数据库名称
     * @param metric 指标名称
     * @param tags 标签过滤器
     * @param options 选项
     * @returns Promise 解析为最新数据点
     */
    getLatestDatapoint(database: string, metric: string, tags?: Record<string, string>, options?: TsdbDataClientOptions): Promise<BceResponse<DataPoint[]>>;
    /**
     * 删除数据
     * @param options 删除选项
     * @returns Promise 解析为删除结果
     */
    deleteData(options: DeleteOptions): Promise<BceResponse<any>>;
    /**
     * 获取时间序列信息
     * @param database 数据库名称
     * @param tsuid 时间序列唯一标识
     * @param options 选项
     * @returns Promise 解析为时间序列信息
     */
    getTimeSeries(database: string, tsuid: string, options?: TsdbDataClientOptions): Promise<BceResponse<TimeSeriesInfo>>;
    /**
     * 搜索时间序列
     * @param database 数据库名称
     * @param metric 指标名称
     * @param tags 标签过滤器
     * @param options 选项
     * @returns Promise 解析为时间序列列表
     */
    searchTimeSeries(database: string, metric?: string, tags?: Record<string, string>, options?: TsdbDataClientOptions): Promise<BceResponse<TimeSeriesInfo[]>>;
    /**
     * 获取指标列表
     * @param database 数据库名称
     * @param options 选项
     * @returns Promise 解析为指标列表
     */
    getMetrics(database: string, options?: TsdbDataClientOptions): Promise<BceResponse<string[]>>;
    /**
     * 获取标签键列表
     * @param database 数据库名称
     * @param metric 指标名称（可选）
     * @param options 选项
     * @returns Promise 解析为标签键列表
     */
    getTagKeys(database: string, metric?: string, options?: TsdbDataClientOptions): Promise<BceResponse<string[]>>;
    /**
     * 获取标签值列表
     * @param database 数据库名称
     * @param tagKey 标签键
     * @param metric 指标名称（可选）
     * @param options 选项
     * @returns Promise 解析为标签值列表
     */
    getTagValues(database: string, tagKey: string, metric?: string, options?: TsdbDataClientOptions): Promise<BceResponse<string[]>>;
    /**
     * 导出数据
     * @param database 数据库名称
     * @param metric 指标名称
     * @param start 开始时间
     * @param end 结束时间
     * @param tags 标签过滤器
     * @param options 选项
     * @returns Promise 解析为导出结果
     */
    exportData(database: string, metric: string, start: number, end: number, tags?: Record<string, string>, options?: TsdbDataClientOptions): Promise<BceResponse<any>>;
}
export {};
//# sourceMappingURL=tsdb_data_client.d.ts.map