InfluxQL ofrece un conjunto completo de comandos administrativos.

Gestión de datos: Gestión de políticas de retención:
CREAR BASE DE DATOS CREAR POLÍTICA DE RETENCIÓN
DROP DATABASE ALTERAR LA POLÍTICA DE RETENCIÓN
SERIE GOTA POLÍTICA DE RETENCIÓN DE GOTAS
ELIMINAR
MEDICIÓN DE GOTA
DROP SHARD

Si estas buscando SHOW consultas (por ejemplo, SHOW DATABASES o SHOW RETENTION POLICIES), consulte Exploración de esquemas.

Los ejemplos de las secciones siguientes utilizan la interfaz de línea de comandos (CLI) de InfluxDB. También puede ejecutar los comandos utilizando la API HTTP; simplemente envía un GET solicitud a la /query endpoint e incluir el comando en el parámetro de URL q. Consulte la guía Consulta de datos para obtener más información sobre el uso de la API HTTP.

Nota: Cuando la autenticación está habilitada, solo los usuarios administradores pueden ejecutar la mayoría de los comandos enumerados en esta página. Consulte la documentación sobre autenticación y autorización para obtener más información.

Gestión de datos

CREAR BASE DE DATOS

Crea una nueva base de datos.

Sintaxis

CREATEDATABASE<database_name>[WITH[DURATION <duration>][REPLICATION<n>][SHARD DURATION <duration>][NAME <retention-policy-name>]]

Descripción de la sintaxis

CREATE DATABASE requiere un nombre de base de datos.

los WITH, DURATION, REPLICATION, SHARD DURATION, y NAME las cláusulas son opcionales y crean una política de retención única asociada con la base de datos creada. Si no especifica una de las cláusulas después WITH, el comportamiento relevante por defecto es el autogen configuración de la política de retención. La política de retención creada sirve automáticamente como política de retención predeterminada de la base de datos. Para obtener más información sobre esas cláusulas, consulte Gestión de políticas de retención.

Un éxito CREATE DATABASE consulta devuelve un resultado vacío. Si intenta crear una base de datos que ya existe, InfluxDB no hace nada y no devuelve un error.

Ejemplos de

Ejemplo 1: crear una base de datos
> CREATE DATABASE "NOAA_water_database"
>

La consulta crea una base de datos llamada NOAA_water_database. De forma predeterminada, InfluxDB también crea el autogen política de retención y la asocia con la NOAA_water_database.

Ejemplo 2: crear una base de datos con una política de retención específica
> CREATE DATABASE "NOAA_water_database" WITH DURATION 3d REPLICATION 1 SHARD DURATION 1h NAME "liquid"
>

La consulta crea una base de datos llamada NOAA_water_database. También crea una política de retención predeterminada para NOAA_water_database con un DURATION de tres días, un factor de replicación de uno, una duración de grupo de fragmentos de una hora y con el nombre liquid.

Eliminar una base de datos con DROP DATABASE

los DROP DATABASE consulta elimina todos los datos, mediciones, series, consultas continuas y políticas de retención de la base de datos especificada. La consulta tiene la siguiente forma:

DROPDATABASE<database_name>

Elimine la base de datos NOAA_water_database:

> DROP DATABASE "NOAA_water_database">

Un éxito DROP DATABASE consulta devuelve un resultado vacío. Si intenta eliminar una base de datos que no existe, InfluxDB no devuelve un error.

Eliminar series del índice con DROP SERIES

los DROP SERIES query elimina todos los puntos de una serie en una base de datos y elimina la serie del índice.

Nota:DROP SERIES no admite intervalos de tiempo en el WHERE cláusula. Ver DELETE para esa funcionalidad.

La consulta toma la siguiente forma, donde debe especificar el FROM cláusula o la WHERE cláusula:

DROP SERIES FROM<measurement_name[,measurement_name]>WHERE<tag_key>=''

Elimine todas las series de una sola medición:

>DROP SERIES FROM"h2o_feet"

Elimine la serie con un par de etiquetas específico de una sola medición:

>DROP SERIES FROM"h2o_feet"WHERE"location"='santa_monica'

Elimine todos los puntos de la serie que tengan un par de etiquetas específico de todas las mediciones en la base de datos:

>DROP SERIES WHERE"location"='santa_monica'

Un éxito DROP SERIES consulta devuelve un resultado vacío.

Eliminar serie con DELETE

los DELETE consulta elimina todos los puntos de una serie en una base de datos. diferente a DROP SERIES, no quita la serie del índice y admite intervalos de tiempo en el WHERE cláusula.

La consulta toma la siguiente forma donde debe incluir el FROM cláusula o la WHERE cláusula, o ambas:

DELETE FROM  WHERE [=''] | [

Eliminar todos los datos asociados con la medición h2o_feet:

> DELETE FROM "h2o_feet"

Eliminar todos los datos asociados con la medición h2o_quality y donde la etiqueta randtag es igual a 3:

> DELETE FROM "h2o_quality" WHERE "randtag" = '3'

Elimine todos los datos de la base de datos que ocurran antes del 1 de enero de 2016:

> DELETE WHERE time < '2016-01-01'

Un éxito DELETE consulta devuelve un resultado vacío.

Cosas a tener en cuenta DELETE:

  • DELETE admite expresiones regulares en el FROM cláusula al especificar los nombres de las mediciones y en el WHERE cláusula al especificar valores de etiqueta.
  • DELETE no admite campos en el WHERE cláusula.
  • Si necesita eliminar puntos en el futuro, debe especificar ese período de tiempo como DELETE SERIES corre por time < now() por defecto. Sintaxis

Eliminar mediciones con DROP MEASUREMENT

los DROP MEASUREMENT consulta borra todos los datos y series de la medida especificada y borra la medida del índice.

La consulta tiene la siguiente forma:

DROP MEASUREMENT <measurement_name>

Eliminar la medida h2o_feet:

>DROP MEASUREMENT "h2o_feet"

Nota:DROP MEASUREMENT elimina todos los datos y series de la medición. No descarta las consultas continuas asociadas.

Un éxito DROP MEASUREMENT consulta devuelve un resultado vacío.

Actualmente, InfluxDB no admite expresiones regulares con DROP MEASUREMENTS. Ver problema de GitHub N.º 4275 para más información.

Eliminar un fragmento con DROP SHARD

los DROP SHARD consulta elimina un fragmento. También suelta el fragmento de la tienda de metadatos. La consulta tiene la siguiente forma:

DROP SHARD <shard_id_number>

Eliminar el fragmento con la identificación 1:

> DROP SHARD 1
>

Un éxito DROP SHARD consulta devuelve un resultado vacío. InfluxDB no devuelve un error si intenta eliminar un fragmento que no existe.

Gestión de políticas de retención

Las siguientes secciones cubren cómo crear, modificar y eliminar políticas de retención. Tenga en cuenta que cuando crea una base de datos, InfluxDB crea automáticamente una política de retención denominada autogen que tiene retención infinita. Puede cambiar el nombre de esa política de retención o deshabilitar su creación automática en el archivo de configuración.

Crea políticas de retención con CREAR POLÍTICA DE RETENCIÓN

Sintaxis

CREATE RETENTION POLICY  ON  DURATION  REPLICATION  [SHARD DURATION ] [DEFAULT]

Descripción de la sintaxis

DURATION

los DURATION La cláusula determina cuánto tiempo InfluxDB conserva los datos. los es una duración literal o INF (infinito). La duración mínima de una política de retención es una hora y la duración máxima es INF.

REPLICATION

los REPLICATION La cláusula determina cuántas copias independientes de cada punto se almacenan en el clúster, donde n es el número de nodos de datos.

Los factores de replicación no sirven para nada con las instancias de un solo nodo.
SHARD DURATION

los SHARD DURATION La cláusula determina el intervalo de tiempo cubierto por un grupo de fragmentos. los es un literal de duración y no admite una INF (infinita) duración. Esta configuración es opcional. De forma predeterminada, la duración del grupo de particiones está determinada por la política de retención DURATION:

DURACIÓN de la política de retención Duración del grupo de fragmentos
<2 días 1 hora
> = 2 días y <= 6 meses 1 día
> 6 meses 7 días

El mínimo permitido SHARD GROUP DURATION es 1h. Si el CREATE RETENTION POLICY consulta intenta establecer el SHARD GROUP DURATION a menos de 1h y mayor que 0s, InfluxDB establece automáticamente el SHARD GROUP DURATION para 1h. Si el CREATE RETENTION POLICY consulta intenta establecer el SHARD GROUP DURATION para 0s, InfluxDB establece automáticamente el SHARD GROUP DURATION de acuerdo con la configuración predeterminada enumerada anteriormente.

Consulte Gestión de la duración del grupo de fragmentos para conocer las configuraciones recomendadas.

DEFAULT

Establece la nueva política de retención como política de retención predeterminada para la base de datos. Esta configuración es opcional.

Ejemplos de

Ejemplo 1: crear una política de retención
> CREATE RETENTION POLICY "one_day_only" ON "NOAA_water_database" DURATION 1d REPLICATION 1
>

La consulta crea una política de retención llamada one_day_only para la base de datos NOAA_water_database con una duración de un día y un factor de replicación de uno.

Ejemplo 2: crear una política de retención PREDETERMINADA
>CREATE RETENTION POLICY "one_day_only"ON"NOAA_water_database" DURATION 23h60m REPLICATION1DEFAULT>

La consulta crea la misma política de retención que la del ejemplo anterior, pero la establece como la política de retención predeterminada para la base de datos.

Un éxito CREATE RETENTION POLICY consulta devuelve una respuesta vacía. Si intenta crear una política de retención idéntica a una que ya existe, InfluxDB no devuelve un error. Si intenta crear una política de retención con el mismo nombre que una política de retención existente pero con atributos diferentes, InfluxDB devuelve un error.

Nota: También puede especificar una nueva política de retención en el CREATE DATABASE consulta. Consulte Crear una base de datos con CREATE DATABASE.

Modifique las políticas de retención con ALTER RETENTION POLICY

los ALTER RETENTION POLICY La consulta tiene la siguiente forma, donde debe declarar al menos uno de los atributos de la política de retención. DURATION, REPLICATION, SHARD DURATION, o DEFAULT:

ALTER RETENTION POLICY <retention_policy_name>ON<database_name> DURATION <duration>REPLICATION<n> SHARD DURATION <duration>DEFAULT
Los factores de replicación no sirven para nada con las instancias de un solo nodo.

Primero, cree la política de retención what_is_time con un DURATION de dos días:

>CREATE RETENTION POLICY "what_is_time"ON"NOAA_water_database" DURATION 2d REPLICATION1>

Modificar what_is_time tener tres semanas DURATION, una duración de grupo de fragmentos de 30 minutos, y conviértalo en el DEFAULT política de retención para NOAA_water_database.

>ALTER RETENTION POLICY "what_is_time"ON"NOAA_water_database" DURATION 3w SHARD DURATION 30m DEFAULT>

En el último ejemplo, what_is_time conserva su factor de replicación original de 1.

Un éxito ALTER RETENTION POLICY consulta devuelve un resultado vacío.

Eliminar políticas de retención con DROP RETENTION POLICY

Elimine todas las mediciones y los datos en una política de retención específica con:

DROP RETENTION POLICY <retention_policy_name>ON<database_name>

Eliminar la política de retención what_is_time en el NOAA_water_database base de datos:

> DROP RETENTION POLICY "what_is_time" ON "NOAA_water_database">

Un éxito DROP RETENTION POLICY consulta devuelve un resultado vacío. Si intenta eliminar una política de retención que no existe, InfluxDB no devuelve un error.