Todos los productos
Search

Este producto

    Tablestore:Crear un túnel

    Centro de documentos

    Tablestore:Crear un túnel

    Última actualización: Sep 29, 2026

    Puede llamar a la operación CreateTunnel para crear uno o más túneles en una tabla. Al crear un túnel, debe especificar el nombre de la tabla, el nombre del túnel y el tipo de túnel.

    Requisitos previos

    • Se inicializó una instancia de TunnelClient.

    • Se creó una tabla de datos. Para obtener más información, consulte Create a data table.

    Parámetros

    Parámetros de solicitud

    Parámetro

    Descripción

    TableName

    Nombre de la tabla de datos para la que desea crear un túnel.

    TunnelName

    Nombre del túnel.

    Type

    Tipo del túnel. Valores válidos: BaseData, Stream y BaseAndStream. El tipo BaseData indica que el túnel se usa para consumir los datos completos de la tabla. El tipo Stream indica que el túnel se usa para consumir los datos incrementales de la tabla. El tipo BaseAndStream indica que el túnel se usa para consumir los datos diferenciales de la tabla.

    Si establece este parámetro en Stream o BaseAndStream, el sistema considera incrementales los datos escritos en la tabla después de crear el túnel. Si desea consumir los datos incrementales generados a partir de un momento específico, configure el parámetro startTime para dichos datos.

    • Valores válidos del parámetro startTime: [Hora actual del sistema - Periodo de validez de Stream + 5 minutos, Hora actual del sistema]. Unidad: nanosegundos.

      Nota

      El periodo de validez de Stream es el tiempo de validez de los registros incrementales, expresado en milisegundos. El periodo máximo de validez de estos registros es de siete días. Puede especificar este periodo cuando habilite Stream para la tabla de datos. Una vez configurado, no es posible modificarlo.

    • También puede configurar el parámetro endTime para los datos incrementales que desee consumir. El valor de endTime debe ser mayor que el valor de startTime.

    Parámetros de respuesta

    Parámetro

    Descripción

    TunnelId

    Identificador del túnel.

    ResponseInfo

    Otros campos devueltos en la respuesta, incluido el campo RequestId de la solicitud. RequestId identifica de forma única la solicitud.

    Ejemplos

    A continuación se muestra un ejemplo de código para crear un túnel de tipo BaseAndStream:

    req := &tunnel.CreateTunnelRequest{
   TableName:  "<TABLE_NAME>",
   TunnelName: "<TUNNEL_NAME>",
   Type:       tunnel.TunnelTypeBaseStream, // Create a tunnel of the BaseAndStream type. 
}
resp, err := tunnelClient.CreateTunnel(req)
if err != nil {
   log.Fatal("create tunnel failed ", err)
}
log.Println("tunnel id is", resp.TunnelId)

    Preguntas frecuentes

    What do I do if the "OTSTrimmedDataAccess Requested stream data is already trimmed or does not exist" error message is returned when I use Tunnel Service to consume data?

    Referencias