Use Tablestore SDK for PHP to update the configurations of a table - Tablestore

Prérequis

Le client est initialisé. Pour plus d'informations, consultez la section Initialiser un client Tablestore.

Description de la méthode

public function updateTable(array $request)

Description du paramètre $request

table_name (obligatoire) string : nom de la table de données.

table_options (facultatif) object : informations de configuration de la table, comprenant les paramètres suivants.

Paramètre	Type	Description
time_to_live (facultatif)	int	Durée de vie (TTL) des données dans la table de données. Unité : secondes. Si vous définissez ce paramètre sur -1, les données n'expirent jamais. Sinon, la valeur minimale est 86400 (un jour). Les données dont la période de rétention dépasse la TTL sont automatiquement supprimées. Pour utiliser les fonctionnalités d'index de recherche ou d'index secondaire, vous devez définir ce paramètre sur -1 ou définir le paramètre allow_update sur false.
max_versions (facultatif)	int	Nombre maximal de versions. Pour utiliser les fonctionnalités d'index de recherche ou d'index secondaire, vous devez définir ce paramètre sur 1.
deviation_cell_version_in_sec (facultatif)	int	Décalage maximal de version. Unité : secondes. La différence entre l'heure système actuelle et l'horodatage des données écrites doit se situer dans la plage du décalage maximal de version. Sinon, l'écriture des données échoue. La plage de versions valides pour les données de colonne d'attribut est `[max(Data written time - Maximum version offset, Data written time - TTL), Data written time + Maximum version offset)`.
allow_update (facultatif)	bool	Indique si les mises à jour sont autorisées. Si vous définissez ce paramètre sur false, vous ne pouvez pas mettre à jour les données à l'aide de la méthode `updateRow()`.

stream_spec (facultatif) object : informations de configuration Stream, comprenant les paramètres suivants.

Paramètre

Type

Description

enable_stream (facultatif)

bool

Indique s'il faut activer Stream.

expiration_time (facultatif)

int

Délai d'expiration Stream, indiquant la durée de conservation des journaux incrémentiels. Unité : heures. La valeur maximale est 168 (7 jours).

Si vous définissez enable_stream sur true, vous devez spécifier expiration_time.

reserved_throughput (facultatif) object : le débit réservé en lecture et en écriture, en CU. Vous ne pouvez définir ce paramètre sur une valeur non nulle que pour les instances haute performance en mode CU.

Remarque

Lorsque vous appelez la méthode updateTable(), vous devez spécifier au moins l'un des paramètres table_options ou stream_spec.

Lorsque vous spécifiez table_options, vous devez indiquer au moins l'un des paramètres time_to_live, max_versions, deviation_cell_version_in_sec ou allow_update.

Exemple de code

L'exemple de code suivant montre comment modifier les informations de configuration de la table test_table.

$request = array (
    'table_name' => 'test_table',
    'table_options' => array (
        'time_to_live' => 86400,
        'max_versions' => 3,
        'deviation_cell_version_in_sec' => 86400,
        'allow_update' => false
    ), 
     'stream_spec' => array (
        'enable_stream' => true,
        'expiration_time' => 168
     ),
    'reserved_throughput' => array (
        'capacity_unit' => array (
            'read' => 0,
            'write' => 0
        )
    )
);

try{
    $client->updateTable( $request );
    echo "Update table succeeded.";
} catch (Exception $e) {
    echo "Update table failed.";
}