Esta página es específica de Data Landing Zone origen conector en el Experience Platform. Para obtener información sobre la conexión a Data Landing Zone destino conector, consulte el Data Landing Zone página de documentación de destino.
Data Landing Zone es una función de almacenamiento de archivos segura y basada en la nube que permite introducir archivos en Adobe Experience Platform. Los datos se eliminan automáticamente del Data Landing Zone después de siete días.
Este tutorial le guiará por los pasos para crear un Data Landing Zone conexión de origen mediante Flow Service API. Este tutorial también proporciona instrucciones sobre cómo recuperar los Data Landing Zone, así como ver y actualizar sus credenciales.
Esta guía requiere una comprensión práctica de los siguientes componentes de Experience Platform:
Las secciones siguientes proporcionan información adicional que deberá conocer para crear correctamente una Data Landing Zone conexión de origen mediante Flow Service API.
Este tutorial también requiere que lea la guía de introducción a las API de Platform para aprender a autenticarse en las API de Platform e interpretar las llamadas de ejemplo proporcionadas en la documentación.
El primer paso para usar las API para acceder a Data Landing Zone es realizar una solicitud de GET al /landingzone
punto final del Connectors API al proporcionar type=user_drop_zone
como parte del encabezado de la solicitud.
Formato de API
GET /data/foundation/connectors/landingzone?type=user_drop_zone
Encabezados | Descripción |
---|---|
user_drop_zone |
El user_drop_zone permite a la API distinguir un contenedor de zona de aterrizaje de otros tipos de contenedores disponibles para usted. |
Solicitud
La siguiente solicitud recupera una zona de aterrizaje existente.
curl -X GET \
'https://platform.adobe.io/data/foundation/connectors/landingzone?type=user_drop_zone' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json'
Respuesta
La siguiente respuesta devuelve información sobre una zona de aterrizaje, incluida su correspondiente containerName
y containerTTL
.
{
"containerName": "dlz-user-container",
"containerTTL": "7"
}
Propiedad | Descripción |
---|---|
containerName |
El nombre de la zona de aterrizaje que ha recuperado. |
containerTTL |
El tiempo de caducidad (en días) aplicado a los datos dentro de la zona de aterrizaje. Cualquier valor dentro de una zona de aterrizaje determinada se elimina después de siete días. |
Para recuperar las credenciales de un Data Landing Zone, realice una solicitud de GET al /credentials
punto final del Connectors API.
Formato de API
GET /data/foundation/connectors/landingzone/credentials?type=user_drop_zone
Solicitud
El siguiente ejemplo de solicitud recupera las credenciales de una zona de aterrizaje existente.
curl -X GET \
'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=user_drop_zone' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
Respuesta
La siguiente respuesta devuelve la información de credenciales de la zona de aterrizaje de datos, incluida la actual SASToken
, SASUri
, storageAccountName
y fecha de caducidad.
{
"containerName": "dlz-user-container",
"SASToken": "sv=2020-04-08&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D",
"storageAccountName": "dlblobstore99hh25i3dflek",
"SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-user-container?sv=2020-04-08&si=dlz-ed86a61d-201f-4b50-b10f-a1bf173066fd&sr=c&sp=racwdlm&sig=4yTba8voU3L0wlcLAv9mZLdZ7NlMahbfYYPTMkQ6ZGU%3D",
"expiryDate": "2024-01-06"
}
Propiedad | Descripción |
---|---|
containerName |
El nombre de su zona de aterrizaje. |
SASToken |
El token de firma de acceso compartido para su zona de aterrizaje. Esta cadena contiene toda la información necesaria para autorizar una solicitud. |
SASUri |
El URI de firma de acceso compartido para su zona de aterrizaje. Esta cadena es una combinación del URI de la zona de aterrizaje para la que se está autenticando y su token SAS correspondiente, |
expiryDate |
La fecha en la que caducará su token SAS. Debe actualizar el token antes de la fecha de caducidad para poder seguir utilizándolo en la aplicación para cargar datos en la zona de aterrizaje de datos. Si no actualiza manualmente el token antes de la fecha de caducidad indicada, se actualizará automáticamente y proporcionará un nuevo token cuando se realice la llamada de credenciales de GET. |
Puede actualizar su SASToken
realizando una petición de POST a la /credentials
punto final del Connectors API.
Formato de API
POST /data/foundation/connectors/landingzone/credentials?type=user_drop_zone&action=refresh
Encabezados | Descripción |
---|---|
user_drop_zone |
El user_drop_zone permite a la API distinguir un contenedor de zona de aterrizaje de otros tipos de contenedores disponibles para usted. |
refresh |
El refresh Esta acción le permite restablecer las credenciales de su zona de aterrizaje y generar automáticamente una nueva SASToken . |
Solicitud
La siguiente solicitud actualiza las credenciales de la zona de aterrizaje.
curl -X POST \
'https://platform.adobe.io/data/foundation/connectors/landingzone/credentials?type=user_drop_zone&action=refresh' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
Respuesta
La siguiente respuesta devuelve valores actualizados para su SASToken
y SASUri
.
{
"containerName": "dlz-user-container",
"SASToken": "sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D",
"storageAccountName": "dlblobstore99hh25i3dflek",
"SASUri": "https://dlblobstore99hh25i3dflek.blob.core.windows.net/dlz-user-container?sv=2020-04-08&si=dlz-9c4d03b8-a6ff-41be-9dcf-20123e717e99&sr=c&sp=racwdlm&sig=JbRMoDmFHQU4OWOpgrKdbZ1d%2BkvslO35%2FXTqBO%2FgbRA%3D",
"expiryDate": "2024-01-06"
}
Puede explorar la estructura de archivos y el contenido de la zona de aterrizaje realizando una solicitud de GET a connectionSpecs
punto final del Flow Service API.
Formato de API
GET /connectionSpecs/{CONNECTION_SPEC_ID}/explore?objectType=root
Parámetro | Descripción |
---|---|
{CONNECTION_SPEC_ID} |
Id. de especificación de conexión correspondiente a Data Landing Zone. Este ID fijo es: 26f526f2-58f4-4712-961d-e41bf1ccc0e8 . |
Solicitud
curl -X GET \
'http://platform.adobe.io/data/foundation/flowservice/connectionSpecs/26f526f2-58f4-4712-961d-e41bf1ccc0e8/explore?objectType=root' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Respuesta
Una respuesta correcta devuelve una matriz de archivos y carpetas encontrados dentro del directorio consultado. Tome nota de la path
propiedad del archivo que desea cargar, ya que es necesario proporcionarla en el siguiente paso para inspeccionar su estructura.
[
{
"type": "file",
"name": "account.csv",
"path": "dlz-user-container/account.csv",
"canPreview": true,
"canFetchSchema": true
},
{
"type": "file",
"name": "data8.csv",
"path": "dlz-user-container/data8.csv",
"canPreview": true,
"canFetchSchema": true
},
{
"type": "folder",
"name": "userdata1",
"path": "dlz-user-container/userdata1/",
"canPreview": false,
"canFetchSchema": false
}
]
Para inspeccionar la estructura de un archivo en la zona de aterrizaje, realice una solicitud de GET y proporcione la ruta y el tipo del archivo como parámetro de consulta.
Formato de API
GET /connectionSpecs/{CONNECTION_SPEC_ID}/explore?objectType=file&object={OBJECT}&fileType={FILE_TYPE}&preview={PREVIEW}
Parámetro | Descripción | Ejemplo |
---|---|---|
{CONNECTION_SPEC_ID} |
Id. de especificación de conexión correspondiente a Data Landing Zone. Este ID fijo es: 26f526f2-58f4-4712-961d-e41bf1ccc0e8 . |
|
{OBJECT_TYPE} |
El tipo de objeto al que desea acceder. | file |
{OBJECT} |
Ruta de acceso y nombre del objeto al que desea tener acceso. | dlz-user-container/data8.csv |
{FILE_TYPE} |
El tipo de archivo. |
|
{PREVIEW} |
Un valor booleano que define si se admite la vista previa del archivo. | true false |
Solicitud
curl -X GET \
'http://platform.adobe.io/data/foundation/flowservice/connectionSpecs/26f526f2-58f4-4712-961d-e41bf1ccc0e8/explore?objectType=file&object=dlz-user-container/data8.csv&fileType=delimited&preview=true' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Respuesta
Una respuesta correcta devuelve la estructura del archivo consultado, incluidos los nombres de archivo y los tipos de datos.
{
"format": "flat",
"schema": {
"columns": [
{
"name": "Id",
"type": "string",
"xdm": {
"type": "string"
}
},
{
"name": "FirstName",
"type": "string",
"xdm": {
"type": "string"
}
},
{
"name": "LastName",
"type": "string",
"xdm": {
"type": "string"
}
},
{
"name": "Email",
"type": "string",
"xdm": {
"type": "string"
}
},
{
"name": "Phone",
"type": "string",
"xdm": {
"type": "string"
}
}
]
},
"data": [
{
"Email": "rsmith@abc.com",
"FirstName": "Richard",
"Phone": "111111111",
"Id": "12345",
"LastName": "Smith"
},
{
"Email": "morgan@bac.com",
"FirstName": "Morgan",
"Phone": "22222222222",
"Id": "67890",
"LastName": "Hart"
}
]
}
determineProperties
para detectar automáticamente la información de propiedad de archivo de un Data Landing ZonePuede usar el complemento determineProperties
para detectar automáticamente la información de propiedad del contenido del archivo de su Data Landing Zone al realizar una llamada de GET para explorar el contenido y la estructura de su origen.
determineProperties
casos de usoEn la tabla siguiente se describen los diferentes escenarios que pueden producirse al utilizar el determineProperties
parámetro de consulta o proporcionar manualmente información sobre el archivo.
determineProperties |
queryParams |
Respuesta |
---|---|---|
True | N/A | If determineProperties se proporciona como parámetro de consulta, se produce la detección de las propiedades del archivo y la respuesta devuelve un nuevo properties que incluye información sobre el tipo de archivo, el tipo de compresión y el delimitador de columna. |
N/A | True | Si los valores de tipo de archivo, tipo de compresión y delimitador de columna se proporcionan manualmente como parte de queryParams , se utilizan para generar el esquema y se devuelven las mismas propiedades como parte de la respuesta. |
True | True | Si ambas opciones se realizan simultáneamente, se devuelve un error. |
N/A | N/A | Si no se proporciona ninguna de las dos opciones, se devuelve un error porque no hay forma de obtener propiedades para la respuesta. |
Formato de API
GET /connectionSpecs/{CONNECTION_SPEC_ID}/explore?objectType=file&object={OBJECT}&fileType={FILE_TYPE}&preview={PREVIEW}&determineProperties=true
Parámetro | Descripción | Ejemplo |
---|---|---|
determineProperties |
Este parámetro de consulta permite Flow Service API para detectar información sobre las propiedades del archivo, incluida información sobre el tipo de archivo, el tipo de compresión y el delimitador de columna. | true |
Solicitud
curl -X GET \
'https://platform.adobe.io/data/foundation/flowservice/connectionSpecs/26f526f2-58f4-4712-961d-e41bf1ccc0e8/explore?objectType=file&object=dlz-user-container/garageWeek/file1&preview=true&determineProperties=true' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}'
Respuesta
Una respuesta correcta devuelve la estructura del archivo consultado, incluidos los nombres de archivo y los tipos de datos, así como un properties
clave, que contiene información sobre fileType
, compressionType
, y columnDelimiter
.
{
"properties": {
"fileType": "delimited",
"compressionType": "tarGzip",
"columnDelimiter": "~"
},
"format": "flat",
"schema": {
"columns": [
{
"name": "id",
"type": "string",
"xdm": {
"type": "string"
}
},
{
"name": "firstName",
"type": "string",
"xdm": {
"type": "string"
}
},
{
"name": "lastName",
"type": "string",
"xdm": {
"type": "string"
}
},
{
"name": "email",
"type": "string",
"xdm": {
"type": "string"
}
},
{
"name": "birthday",
"type": "string",
"xdm": {
"type": "string"
}
}
]
},
"data": [
{
"birthday": "1313-0505-19731973",
"firstName": "Yvonne",
"lastName": "Thilda",
"id": "100",
"email": "Yvonne.Thilda@yopmail.com"
},
{
"birthday": "1515-1212-19731973",
"firstName": "Mary",
"lastName": "Pillsbury",
"id": "101",
"email": "Mary.Pillsbury@yopmail.com"
},
{
"birthday": "0505-1010-19751975",
"firstName": "Corene",
"lastName": "Joeann",
"id": "102",
"email": "Corene.Joeann@yopmail.com"
},
{
"birthday": "2727-0303-19901990",
"firstName": "Dari",
"lastName": "Greenwald",
"id": "103",
"email": "Dari.Greenwald@yopmail.com"
},
{
"birthday": "1717-0404-19651965",
"firstName": "Lucy",
"lastName": "Magdalen",
"id": "199",
"email": "Lucy.Magdalen@yopmail.com"
}
]
}
Propiedad | Descripción |
---|---|
properties.fileType |
El tipo de archivo correspondiente del archivo consultado. Los tipos de archivo admitidos son: delimited , json , y parquet . |
properties.compressionType |
El tipo de compresión correspondiente utilizado para el archivo consultado. Los tipos de compresión admitidos son:
|
properties.columnDelimiter |
El delimitador de columna correspondiente utilizado para el archivo consultado. Cualquier valor de carácter único es un delimitador de columna admisible. El valor predeterminado es una coma (,) . |
Una conexión de origen crea y administra la conexión con el origen externo desde el que se incorporan los datos. Una conexión de origen consta de información como el origen de datos, el formato de datos y el ID de conexión de origen necesario para crear un flujo de datos. Una instancia de conexión de origen es específica de un inquilino y una organización.
Para crear una conexión de origen, realice una solicitud de POST al /sourceConnections
punto final del Flow Service API.
Formato de API
POST /sourceConnections
Solicitud
curl -X POST \
'https://platform.adobe.io/data/foundation/flowservice/sourceConnections' \
-H 'Authorization: Bearer {ACCESS_TOKEN}' \
-H 'x-api-key: {API_KEY}' \
-H 'x-gw-ims-org-id: {ORG_ID}' \
-H 'x-sandbox-name: {SANDBOX_NAME}' \
-H 'Content-Type: application/json' \
-d '{
"name": "Data Landing Zone source connection",
"data": {
"format": "delimited"
},
"params": {
"path": "dlz-user-container/data8.csv"
},
"connectionSpec": {
"id": "26f526f2-58f4-4712-961d-e41bf1ccc0e8",
"version": "1.0"
}
}'
Propiedad | Descripción |
---|---|
name |
El nombre de su Data Landing Zone conexión de origen. |
data.format |
El formato de los datos que desea llevar a Platform. |
params.path |
La ruta al archivo que desea llevar a Platform. |
connectionSpec.id |
Id. de especificación de conexión correspondiente a Data Landing Zone. Este ID fijo es: 26f526f2-58f4-4712-961d-e41bf1ccc0e8 . |
Respuesta
Una respuesta correcta devuelve el identificador único (id
) de la conexión de origen recién creada. Este ID es necesario en el siguiente tutorial para crear un flujo de datos.
{
"id": "f5b46949-8c8d-4613-80cc-52c9c039e8b9",
"etag": "\"1400d460-0000-0200-0000-613be3520000\""
}
Al seguir este tutorial, ha recuperado su Data Landing Zone , exploró su estructura de archivos para encontrar el archivo que desea llevar a Platform y creó una conexión de origen para empezar a llevar los datos a Platform. Ahora puede continuar con el siguiente tutorial, donde aprenderá a crear un flujo de datos para llevar los datos de almacenamiento en la nube a Platform mediante Flow Service API.