GeminiDB Influx实例操作的基础语法使用示例

本章节主要介绍GeminiDB Influx实例操作的基础语法使用。

• 库语法
  • 创建数据库。

    create_database_stmt = "CREATE DATABASE" db_name

    [ WITH

    [ retention_policy_duration ]

    [ retention_policy_replication ]

    [ retention_policy_shard_group_duration ]

    [ retention_policy_name ]

    ] .

    

    上述命令中，[]表示可选选项。

    示例：

    • 创建名称为“mydb”的数据库。

      CREATE DATABASE "mydb"

    • 创建名称为“mydb”的数据库，使用指定的保留策略，名称为“myrp”，保留时间为1天，副本数量为1，shardGroup的存储时间为30分钟。

      CREATE DATABASE "mydb" WITH DURATION 1d REPLICATION 1 SHARD DURATION 30m NAME "myrp"

    • 创建名称为“mydb”的数据库，使用默认的保留策略，保留策略名称为“myrp”。

      CREATE DATABASE "mydb" WITH NAME "myrp"

  • 查询数据库

    SHOW DATABASES

  • 切换数据库

    USE db_name

  • 删除数据库

    DROP DATABASE "db_name"

    

• RETENTION POLICY语法
  • 创建RETENTION POLICY，当前RETENTION POLICY命名中不能包含逗号、冒号、分号和点号。

    create_retention_policy_stmt = "CREATE RETENTION POLICY" policy_name on_clause

    retention_policy_duration

    retention_policy_replication

    [ retention_policy_shard_group_duration ]

    [ "DEFAULT" ] .

    

    上述命令中，[]表示可选选项。

    示例：

    • 创建数据保留策略。

      CREATE RETENTION POLICY "10m_events" ON "somedb" DURATION 60m REPLICATION 2

    • 创建数据保留策略，并将其设置为默认。

      CREATE RETENTION POLICY "10m_events" ON "somedb" DURATION 60m REPLICATION 2 DEFAULT

    • 创建数据保留策略，并指定shardGroup的存储时长。

      CREATE RETENTION POLICY "10m_events" ON "somedb" DURATION 60m REPLICATION 2 SHARD DURATION 30m

  • 查看RETENTION POLICY

    show retention policies on <database name>

    

    

    同时使用retention_policy_duration与retention_policy_shard_group_duration时，retention_policy_duration需大于retention_policy_shard_group_duration。

  • 删除RETENTION POLICY

    DROP RETENTION POLICY policy_name ON db_name

  • 修改RETENTION POLICY

    Alter_retention_policy_stmt = "ALTER RETENTION POLICY" policy_name on_clause

    retention_policy_option

    [ retention_policy_option ]

    [ retention_policy_option ]

    [ retention_policy_option ] .

    

    上述命令中，[]表示可选选项。

    示例：

    • 修改默认保留策略。

      ALTER RETENTION POLICY "1h_cpu" ON "mydb" DEFAULT

    • 修改保留时间和副本数量。

      ALTER RETENTION POLICY "policy1" ON "somedb" DURATION 1h REPLICATION 4

• 新增数据

  insert into <retention policy> measurement,tagKey=tagValue fieldKey=fieldValue timestamp

  

  插入数据时，系统会根据需要创建measurement。

  • 使用默认的retention policy。

    insert demo,name=LiSi math=99,english=90,language=95

    新增数据，measurement为demo，tag为name，field为math、english和language

  • 使用指定的retention policy。

    insert into rp_1_hours demo,name=ZhangSan math=99,english=90,language=95

• 查询数据
  • 在默认RETENTION POLICY中查询

    select * from demo where time < xxx and time > xxx

  • 在指定RETENTION POLICY中查询

    select * from rp_1_hours.demo where time < xxx and time > xxx

    

    查询语句需要指定查询的时间范围，包括上界和下界。

• 修改数据

  使用insert来修改数据，当所有tag和timestamp完全相同时，insert会覆盖原有内容。

  

• 删除数据

  建议根据需求设置合理的RETENTION POLICY，通过RETENTION POLICY自动删除数据。

• HELP命令
  • HELP，查看所有支持的命令。
    图1 查看支持的全部命令
    
  • HELP <COMMAND>，查询某一命令的使用方法。

    示例：HELP DESC