Todos los productos
Search
Centro de documentos

Tablestore:Export full data to OSS

Última actualización: Sep 08, 2026

Este método ofrece una forma rentable de respaldar datos o exportarlos como archivos. Posteriormente, puede descargar los archivos exportados a su computadora local.

Requisitos previos

Antes de comenzar, complete las siguientes preparaciones:

Nota

Si su espacio de trabajo de DataWorks y su instancia de Tablestore se encuentran en regiones distintas, debe crear una conexión de emparejamiento de VPC para habilitar la conectividad de red entre regiones.

Crear una conexión de emparejamiento de VPC para la conectividad de red entre regiones

A continuación se muestra cómo configurar una conexión cuando la instancia de la tabla de origen está en la región China (Shanghai) y el espacio de trabajo de DataWorks está en la región China (Hangzhou).

  1. Vincule una VPC a la instancia de Tablestore.

    1. Inicie sesión en la consola de Tablestore. En la barra de navegación superior, seleccione la región donde se encuentra la tabla de destino.

    2. Haga clic en el alias de la instancia para ir a la página Instance Management.

    3. En la pestaña Network Management, haga clic en Bind VPC, seleccione una VPC y un vSwitch, introduzca un nombre para la VPC y luego haga clic en OK.

    4. Espere a que se vincule la VPC. La página se actualiza automáticamente para mostrar el VPC ID y la VPC Address vinculados en la lista de VPC.

      Nota

      Cuando agregue un origen de datos de Tablestore en la consola de DataWorks, debe usar esta dirección de VPC.

  2. Obtenga la información de VPC del resource group del espacio de trabajo de DataWorks.

    1. Inicie sesión en la consola de DataWorks. En la barra de navegación superior, seleccione la región donde se encuentra su espacio de trabajo. En el panel de navegación izquierdo, haga clic en Workspaces para ir a la página Workspace list.

    2. Haga clic en el nombre del espacio de trabajo para ir a la página Workspace Details. En el panel de navegación izquierdo, haga clic en Resource Group para consultar la lista de resource groups vinculados al espacio de trabajo.

    3. En la fila del resource group de destino, haga clic en Network Settings. En la sección Resource Scheduling & Data Integration, consulte el VPC ID de la VPC vinculada.

  3. Cree una conexión de emparejamiento de VPC y configure las rutas.

    1. Inicie sesión en la consola de VPC. En el panel de navegación izquierdo, haga clic en VPC Peering Connection y luego haga clic en Create VPC Peering Connection.

    2. En la página Create VPC Peering Connection, introduzca un nombre para la conexión de emparejamiento, seleccione la instancia de VPC solicitante, el tipo de cuenta aceptadora, la región aceptadora y la instancia de VPC aceptadora, y luego haga clic en OK.

    3. En la página VPC Peering Connection, busque la conexión de emparejamiento de VPC que creó y haga clic en Configure route tanto en la columna Requester VPC como en la columna Accepter.

      El bloque CIDR de destino debe ser el bloque CIDR de la VPC par. Cuando configure una entrada de ruta para el solicitante, introduzca el bloque CIDR del aceptador. Cuando configure una entrada de ruta para el aceptador, introduzca el bloque CIDR del solicitante.

Procedimiento

Siga estos pasos para configurar y ejecutar la tarea de exportación de datos.

Paso 1: Agregar un origen de datos de Tablestore

Configure un origen de datos de Tablestore en DataWorks para conectarse a sus datos de origen.

  1. Inicie sesión en la consola de DataWorks. Cambie a la región de destino. En el panel de navegación izquierdo, elija Data integration > Data integration. En la lista desplegable, seleccione el espacio de trabajo deseado y haga clic en Go to Data Integration.

  2. En el panel de navegación izquierdo, haga clic en Data Source.

  3. En la página Data Sources, haga clic en Add Data Source.

  4. En el cuadro de diálogo Add Data Source, busque y seleccione Tablestore como tipo de origen de datos.

  5. En el cuadro de diálogo Add OTS Data Source, configure los parámetros del origen de datos tal como se describe en la siguiente tabla.

    Parámetro

    Descripción

    Data source name

    Nombre del origen de datos. Puede contener letras, dígitos y guiones bajos (_), pero no puede comenzar con un dígito ni con un guion bajo (_).

    Data source description

    Descripción breve del origen de datos. Puede tener hasta 80 caracteres de longitud.

    Region

    Seleccione la región donde se encuentra la instancia de Tablestore.

    Tablestore Instance Name

    Nombre de la instancia de Tablestore.

    Endpoint

    Endpoint de la instancia de Tablestore. Se recomienda usar la VPC Address.

    AccessKey ID

    AccessKey ID y AccessKey Secret de su cuenta de Alibaba Cloud o usuario de RAM.

    AccessKey Secret

  6. Compruebe la conectividad del resource group.

    Debe comprobar la conectividad del resource group con el origen de datos. La tarea de sincronización no se puede ejecutar si el resource group no logra conectarse al origen de datos.

    1. En la sección Connection Configuration, haga clic en Test Network Connectivity en la columna Connection Status del resource group.

    2. Una vez superada la prueba de conectividad, el estado Connection Status cambia a Connected. Haga clic en Complete. El nuevo origen de datos aparecerá en la lista de orígenes de datos.

      Si el resultado de la prueba de conectividad es Failed, utilice la Network Connectivity Diagnostic Tool para resolver el problema por su cuenta.

Paso 2: Agregar un origen de datos de OSS

Configure un origen de datos de OSS como destino de la exportación de datos.

  1. Haga clic nuevamente en Add Data Source. En el cuadro de diálogo, busque y seleccione OSS como tipo de origen de datos, y luego configure los parámetros.

    Parámetro

    Descripción

    Data source name

    Solo puede contener letras, dígitos y guiones bajos (_), y no puede comenzar con un dígito ni con un guion bajo.

    Data source description

    Introduzca una descripción breve del origen de datos, de no más de 80 caracteres.

    Access Mode

    • RAM Role Authorization Mode: la cuenta de servicio de DataWorks accede al origen de datos asumiendo un rol de RAM. Si es la primera vez que selecciona este modo, siga las instrucciones en pantalla para otorgar los permisos obligatorios.

    • Access Key Mode: acceda al origen de datos mediante el AccessKey ID y el AccessKey Secret de una cuenta de Alibaba Cloud o un usuario de RAM.

    Select Role

    Solo necesita seleccionar un rol de RAM cuando el Access Mode es RAM Role Authorization Mode.

    AccessKey ID

    El AccessKey ID y el AccessKey Secret de una cuenta de Alibaba Cloud o un usuario de RAM solo son necesarios cuando el Access Mode se establece en AccessKey Mode.

    AccessKey secret

    Region

    Región donde se encuentra el bucket.

    Endpoint

    Para conocer los nombres de dominio de acceso de OSS, consulte Regions and Endpoints.

    Bucket

    Nombre del bucket.

  2. Después de configurar los parámetros y superar la prueba de conectividad, haga clic en Complete.

Paso 3: Configurar una tarea de sincronización por lotes

Cree y configure una tarea de sincronización por lotes para definir la transferencia de datos de Tablestore a OSS.

Crear un nodo de tarea

  1. Vaya a la página Data Development.

    1. Inicie sesión en la consola de DataWorks.

    2. En la barra de navegación superior, seleccione el resource group y la región.

    3. En el panel de navegación izquierdo, haga clic en Data Development and O&M > Data Development.

    4. Seleccione el espacio de trabajo correspondiente y haga clic en Go To Data Studio.

  2. En la consola de Data Studio, dentro de la página Data Development, haga clic en el icono image situado a la derecha de Workspace Directory y seleccione New Node > Data integration > Batch Synchronization.

  3. En el cuadro de diálogo New Node, seleccione una Path. Establezca el origen de datos en Tablestore y el destino de datos en OSS. Introduzca un Name y haga clic en Confirm.

Configurar la tarea de sincronización

En Workspace Directory, haga clic en el nuevo nodo de tarea de sincronización por lotes para abrirlo. Configure la tarea de sincronización mediante la interfaz sin código o el editor de código.

Interfaz sin código

Configure los siguientes elementos:

  • Data source: seleccione los orígenes de datos de origen y de destino.

  • Runtime Resource: seleccione un resource group. A continuación, el sistema comprueba automáticamente la conectividad del origen de datos.

  • Data Source:

    • Table: seleccione la tabla de datos de origen en la lista desplegable.

    • Primary Key Range (Start): inicio del rango de clave primaria que se va a leer, especificado como un arreglo JSON. El valor inf_min representa infinito negativo.

      Si la clave primaria consta de una columna de clave primaria int llamada id y una columna de clave primaria string llamada name, consulte los siguientes ejemplos de configuración:

      Rango de clave primaria

      Datos completos

      [
        {
          "type": "int",
          "value": "000"
        },
        {
          "type": "string",
          "value": "aaa"
        }
      ]
      [
            {
              "type": "inf_min"
            },
            {
              "type": "inf_min"
            }
          ]
    • Primary Key Range (End): fin del rango de clave primaria que se va a leer, especificado como un arreglo JSON. El valor inf_max representa infinito positivo.

      Si la clave primaria consta de una columna de clave primaria int llamada id y una columna de clave primaria string llamada name, consulte los siguientes ejemplos de configuración:

      Rango de clave primaria

      Datos completos

      [
        {
          "type": "int",
          "value": "999"
        },
        {
          "type": "string",
          "value": "zzz"
        }
      ]
      [
            {
              "type": "inf_max"
            },
            {
              "type": "inf_max"
            }
          ]
    • Splitting Configuration: por lo general, este parámetro no es obligatorio. Establézcalo en [].

      Si los puntos críticos de sus datos de Tablestore hacen que la política de división automática sea ineficaz, utilice reglas de división personalizadas. Estas reglas definen puntos de división dentro del rango de clave primaria. Solo necesita configurar la clave de división, no todas las columnas de clave primaria.

  • Destination: seleccione el Text Type de destino y configure los parámetros relacionados.

    • Text Type: las opciones incluyen csv, text, orc y parquet.

    • Object Name (Path Included): ruta y nombre del archivo de destino en el bucket de OSS. Ejemplo: tablestore/resource_table.csv.

    • Column Delimiter: el valor predeterminado es ,. Si el delimitador es un carácter no imprimible, introduzca su codificación Unicode, como \u001b o \u007c.

    • Object Path: obligatorio solo para el tipo de texto parquet. Especifica la ruta del archivo dentro del bucket de OSS.

    • File Name: obligatorio solo para el tipo de texto parquet. Especifica el nombre del archivo dentro del bucket de OSS.

  • Destination Field Mapping: asigna los campos de la tabla de origen al archivo de destino. Cada línea, especificada en formato JSON, representa un campo.

    • Source Field: incluye los campos de clave primaria y las columnas de atributos de la tabla de origen.

      Si la clave primaria consta de una columna de clave primaria int llamada id y una columna de clave primaria string llamada name, y existe una columna de atributos int llamada age, consulte el siguiente ejemplo:

      {"name":"id","type":"int"}
      {"name":"name","type":"string"}
      {"name":"age","type":"int"}
    • Target Field: incluye los campos de clave primaria y las columnas de atributos de la tabla de origen.

      Si la clave primaria consta de una columna de clave primaria int llamada id y una columna de clave primaria string llamada name, y existe una columna de atributos int llamada age, consulte el siguiente ejemplo:

      {"name":"id","type":"int"}
      {"name":"name","type":"string"}
      {"name":"age","type":"int"}

Una vez completada la configuración, haga clic en Save en la parte superior de la página.

Modo script

En la parte superior de la página, haga clic en Code Editor para cambiar a la vista de edición de scripts.

El siguiente script de ejemplo sirve para exportar a un archivo CSV. La clave primaria de la tabla de origen consta de una columna int llamada id y una columna string llamada name . La tabla también incluye una columna de atributos int llamada age . Cuando utilice el script, reemplace los valores de datasource , table y object por los suyos.
{
    "type": "job",
    "version": "2.0",
    "steps": [
        {
            "stepType": "ots",
            "parameter": {
                "datasource": "source_data",
                "column": [
                    {
                        "name": "id",
                        "type": "int"
                    },
                    {
                        "name": "name",
                        "type": "string"
                    },
                    {
                        "name": "age",
                        "type": "int"
                    }
                ],
                "range": {
                    "begin": [
                        {
                            "type": "inf_min"
                        },
                        {
                            "type": "inf_min"
                        }
                    ],
                    "end": [
                        {
                            "type": "inf_max"
                        },
                        {
                            "type": "inf_max"
                        }
                    ],
                    "split": []
                },
                "table": "source_table",
                "newVersion": "true"
            },
            "name": "Reader",
            "category": "reader"
        },
        {
            "stepType": "oss",
            "parameter": {
                "dateFormat": "yyyy-MM-dd HH:mm:ss",
                "datasource": "target_data",
                "writeSingleObject": false,
                "column": [
                    {
                        "name": "id",
                        "type": "int"
                    },
                    {
                        "name": "name",
                        "type": "string"
                    },
                    {
                        "name": "age",
                        "type": "int"
                    }
                ],
                "writeMode": "truncate",
                "encoding": "UTF-8",
                "fieldDelimiter": ",",
                "fileFormat": "csv",
                "object": "tablestore/source_table.csv"
            },
            "name": "Writer",
            "category": "writer"
        }
    ],
    "setting": {
        "errorLimit": {
            "record": "0"
        },
        "speed": {
            "concurrent": 2,
            "throttle": false
        }
    },
    "order": {
        "hops": [
            {
                "from": "Reader",
                "to": "Writer"
            }
        ]
    }
}

Cuando termine de editar el script, haga clic en Save en la parte superior de la página.

Ejecutar la tarea de sincronización

Haga clic en Run en la parte superior de la página para iniciar la tarea de sincronización. La primera vez que ejecute la tarea, deberá confirmar la Debug Configuration.

Paso 4: Consultar los resultados de la sincronización

Una vez finalizada la tarea, puede comprobar su estado de ejecución en los registros y consultar el archivo resultante en su bucket de OSS.

  1. Consulte el estado y el resultado de ejecución de la tarea en la parte inferior de la página. La siguiente información de registro indica que la tarea de sincronización se completó correctamente.

    2025-11-18 11:16:23 INFO Shell run successfully!
    2025-11-18 11:16:23 INFO Current task status: FINISH
    2025-11-18 11:16:23 INFO Cost time is: 77.208s
  2. Consulte el archivo en el bucket de destino.

    Vaya a la lista de buckets, haga clic en el bucket de destino y luego consulte o descargue el archivo de resultados.

Preguntas frecuentes

Temas relacionados