Listar túneles - Tablestore - Centro de documentación de Alibaba Cloud

Utilice Tablestore SDK for Java para listar todos los túneles de una tabla y obtener sus tipos, etapas y configuraciones.

Requisitos previos

Instale Tablestore SDK for Java y initialize TunnelClient.

Descripción de la función

Llame a listTunnel para listar todos los túneles de una tabla. La respuesta no incluye información sobre los canales de cada túnel. Para obtener la información de los canales, consulte los detalles de un túnel específico.

ListTunnelResponse listTunnel(ListTunnelRequest request)
        throws TableStoreException, ClientException

A continuación se muestra un ejemplo que lista todos los túneles de la tabla example_table e imprime el nombre, tipo, etapa y hora de creación de cada túnel:

String tableName = "example_table";

ListTunnelRequest request = new ListTunnelRequest(tableName);
ListTunnelResponse response = tunnelClient.listTunnel(request);

for (TunnelInfo tunnelInfo : response.getTunnelInfos()) {
    System.out.printf(
            "name=%s, type=%s, stage=%s, createTime=%d%n",
            tunnelInfo.getTunnelName(),
            tunnelInfo.getTunnelType(),
            tunnelInfo.getStage(),
            tunnelInfo.getCreateTime());
}

Parámetros

request es de tipo ListTunnelRequest y contiene el siguiente parámetro:

Nombre	Tipo	Descripción
tableName (obligatorio)	`String`	El nombre de la tabla.

Valores de retorno

El valor de retorno es de tipo ListTunnelResponse y contiene el siguiente campo:

Nombre	Tipo	Descripción
tunnelInfos	`List<TunnelInfo>`	La lista de túneles en la tabla. Llame a `getTunnelInfos()` para obtener este campo.

Información del túnel

Cada elemento en tunnelInfos[] es de tipo TunnelInfo y contiene los siguientes campos:

Nombre	Tipo	Descripción
tunnelName	`String`	El nombre del túnel.
tunnelId	`String`	El ID del túnel.
tunnelType	`TunnelType`	El tipo de túnel. Valores válidos: `BaseData`, `Stream` y `BaseAndStream`. Estos valores indican solo datos completos, solo datos incrementales y datos completos seguidos de datos incrementales, respectivamente.
tableName	`String`	El nombre de la tabla.
instanceName	`String`	El nombre de la instancia.
stage	`TunnelStage`	La etapa del túnel. Valores válidos: `InitBaseDataAndStreamShard`, `ProcessBaseData` y `ProcessStream`. Estos valores indican inicialización, procesamiento de datos completos y procesamiento de datos incrementales, respectivamente.
expired	`boolean`	Indica si los datos del túnel han caducado.
streamTunnelConfig	`StreamTunnelConfig`	La configuración del rango de datos incrementales. Si no se configuró este parámetro, se devuelve la configuración predeterminada. Los túneles de tipo `BaseData` no utilizan esta configuración. Para más información sobre los campos, consulte Create a tunnel.
createTime	`long`	La hora de creación del túnel. El valor es una marca de tiempo UNIX en milisegundos.
streamRecordOptions	`StreamRecordOptions`	La configuración del contenido de registros incrementales. Si no se configuró este parámetro, se devuelve la configuración predeterminada. Los túneles de tipo `BaseData` no utilizan esta configuración. Este campo requiere Tablestore SDK for Java 5.17.11 o posterior. Para más información sobre los campos, consulte Create a tunnel.