SDK de Java - DataHub - Centro de documentación de Alibaba Cloud

Instalación del SDK

Agregue la siguiente dependencia a su proyecto de Maven:

<dependency>
  <groupId>com.aliyun.datahub</groupId>
  <artifactId>aliyun-sdk-datahub</artifactId>
  <version>2.29.5</version>
</dependency>

JDK: Use la versión 1.8 o posterior.
Si la API requiere autenticación por clave, configure el AccessKey ID y el AccessKey Secret en su proyecto. Para obtener más información, consulte Autenticación.

Autenticación

Contexto

Un AccessKey (AK) es una clave de acceso que proporciona Alibaba Cloud para autenticar las llamadas a OpenAPI. Se compone de un AccessKey ID y un AccessKey Secret. Debe mantener ambos en confidencialidad.

Alibaba Cloud Credentials es una herramienta de gestión de credenciales para desarrolladores de Alibaba Cloud. Configurar la cadena predeterminada de proveedores de credenciales le permite llamar a OpenAPI de Alibaba Cloud sin codificar su AccessKey en texto plano. Esto ayuda a proteger sus recursos en la nube.

Requisitos previos

Obtenga el AccessKey ID y el AccessKey Secret de un usuario de RAM. Para consultar las instrucciones, véase View the AccessKey information of a RAM user.
Importante
La filtración de un AccessKey de su cuenta principal compromete todos los recursos asociados a ella. Para proteger su cuenta, cree un AccessKey para un usuario de RAM y evite crear uno para su cuenta principal, salvo que sea estrictamente necesario.

El AccessKey Secret de un usuario de RAM solo se muestra al crear el AccessKey y no se puede recuperar posteriormente. Guarde el AccessKey Secret de forma segura de inmediato.
Instale la herramienta Alibaba Cloud Credentials.

Para instalar con Maven (se recomienda usar la versión más reciente de Credentials):
```
<dependency>
 <groupId>com.aliyun</groupId>
 <artifactId>credentials-java</artifactId>
 <version>0.2.11</version>
</dependency>
```
Instale JDK 1.7 o posterior.

Métodos de configuración

Este tema toma como ejemplo las variables de entorno. Para conocer otros métodos de configuración, consulte Configure environment variables.

Importante

Cuando use un archivo de configuración, asegúrese de que las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET no estén definidas en su sistema. Si están configuradas, tendrán prioridad sobre el archivo de configuración.

Puede crear una credencial de acceso predeterminada al establecer las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET. Su aplicación usará automáticamente estas variables para autenticar las llamadas a la API.

Configuración de variables de entorno

Establezca las variables de entorno ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET.

Para sistemas Linux y macOS

Ejecute los siguientes comandos:
```
export ALIBABA_CLOUD_ACCESS_KEY_ID=<access_key_id>
export ALIBABA_CLOUD_ACCESS_KEY_SECRET=<access_key_secret>
```
Reemplace <access_key_id> con su AccessKey ID y <access_key_secret> con su AccessKey Secret.
Para sistemas Windows
1. Cree dos nuevas variables de entorno: ALIBABA_CLOUD_ACCESS_KEY_ID y ALIBABA_CLOUD_ACCESS_KEY_SECRET. Asigne como valores su AccessKey ID y su AccessKey Secret, respectivamente.
2. Reinicie Windows.

Ejemplo de código

    Client credentialClient = new Client();
    String accessKeyId = credentialClient.getAccessKeyId();
    String accessKeySecret = credentialClient.getAccessKeySecret();

Notas

Para usuarios que actualizan desde el SDK v2.9: Al reemplazar el método setTimestampInms, multiplique el valor de la marca de tiempo por 1,000.
En condiciones normales de operación, solo las API putRecords / putRecordsByShard y getRecords se invocan con frecuencia para leer y escribir datos. Otras API, como getTopic, getCursor y listShard, suelen llamarse únicamente durante la inicialización.
Puede crear una o más instancias de DatahubClient en su proyecto. Las instancias de DatahubClient son seguras para hilos.
Si encuentra clases con el mismo nombre en diferentes paquetes, tenga en cuenta que la versión 2.12 y posteriores usan clases del paquete com.aliyun.datahub.client. Las clases de otros paquetes se mantienen por compatibilidad con versiones anteriores a la 2.12 del SDK. Por ejemplo:
```
// Version 2.12
com.aliyun.datahub.client.model.RecordSchema
// If your code was written with an SDK version earlier than 2.12 and you want to avoid code changes after upgrading, continue to use this type.
com.aliyun.datahub.common.data.RecordSchema
```
Si ocurre el error Parse body failed, Offset: 0, intente establecer el parámetro enableBinary en false.