Delete time series metadata - Tablestore SDK for Java - Tablestore

Utilisez le SDK Tablestore pour Java pour supprimer plusieurs entrées de métadonnées de séries temporelles et récupérer les erreurs en cas d'échec. La suppression des métadonnées n'entraîne pas celle des données de série temporelle correspondantes.

Prérequis

Installez le SDK Tablestore pour Java et initialisez un client de séries temporelles.

Description

Appelez la méthode deleteTimeseriesMeta pour supprimer plusieurs entrées de métadonnées de séries temporelles en spécifiant leurs identifiants complets. Cette opération supprime uniquement les enregistrements de l'index de métadonnées, sans effacer les données existantes de la série temporelle.

public DeleteTimeseriesMetaResponse deleteTimeseriesMeta(DeleteTimeseriesMetaRequest request) throws TableStoreException, ClientException

L'exemple suivant supprime les métadonnées de la série temporelle spécifiée dans la table example_timeseries_table et vérifie les échecs.

Map<String, String> tags = new HashMap<>();
tags.put("region", "cn-hangzhou");
tags.put("host", "host_0");
TimeseriesKey timeseriesKey =
        new TimeseriesKey("cpu", "source_0", tags);

DeleteTimeseriesMetaRequest request =
        new DeleteTimeseriesMetaRequest("example_timeseries_table");
request.setTimeseriesKeys(Collections.singletonList(timeseriesKey));
DeleteTimeseriesMetaResponse response =
        timeseriesClient.deleteTimeseriesMeta(request);

for (DeleteTimeseriesMetaResponse.FailedRowResult result : response.getFailedRows()) {
    System.out.println(result.getIndex());
    System.out.println(result.getError());
}

Paramètres

L'objet DeleteTimeseriesMetaRequest contient les paramètres suivants.

Nom	Type	Description
timeseriesTableName (obligatoire)	`String`	Nom de la table de séries temporelles.
timeseriesKeys (obligatoire)	`List<TimeseriesKey>`	Liste non vide des identifiants des entrées de métadonnées de séries temporelles à supprimer. Vous pouvez supprimer plusieurs entrées en une seule requête.

Identifiants de séries temporelles

Chaque élément du tableau timeseriesKeys[] est de type TimeseriesKey et contient les paramètres suivants.

Nom	Type	Description
measurementName (obligatoire)	`String`	Nom de la mesure. À partir de la version 5.17.2 du SDK Tablestore pour Java, ce paramètre peut être vide.
dataSource (facultatif)	`String`	Identifiant de la source de données. Peut être vide.
tags (facultatif)	`SortedMap<String, String>`	Tags sous forme de paires clé-valeur de type chaîne. Si ce paramètre n'est pas spécifié, une mappe vide est utilisée. Les identifiants complets de la série temporelle doivent correspondre à l'entrée de métadonnées cible.

Réponse

L'objet DeleteTimeseriesMetaResponse contient le champ spécifique à l'opération suivant.

Champ	Type	Description
`failedRows`	`List<DeleteTimeseriesMetaResponse.FailedRowResult>`	Appelez la méthode `getFailedRows()` pour obtenir les entrées de métadonnées dont la suppression a échoué. Une liste vide indique que toutes les entrées ont été supprimées. Vous pouvez également appeler la méthode `isAllSuccess()` pour vérifier si toutes les entrées ont bien été supprimées.

Informations sur les entrées ayant échoué

Chaque élément du tableau failedRows[] est de type DeleteTimeseriesMetaResponse.FailedRowResult et contient les champs suivants.

Champ	Type	Description
`index`	`int`	Appelez la méthode `getIndex()` pour obtenir l'index de l'entrée de métadonnées en échec dans la liste `timeseriesKeys` de la requête.
`error`	`Error`	Appelez la méthode `getError()` pour obtenir la raison de l'échec.