Créez une connexion source Azure Blob à l’aide de l’API Flow Service.

Ce didacticiel utilise l'Flow Service API pour vous guider dans les étapes de connexion de Azure Blob (ci-après appelé "Blob") à Adobe Experience Platform.

Prise en main

Ce guide nécessite une compréhension professionnelle des composants suivants d’Adobe Experience Platform :

  • Sources : Experience Platform permet l’assimilation de données à partir de diverses sources tout en vous permettant de structurer, d’étiqueter et d’améliorer les données entrantes à l’aide des services de plate-forme.
  • Environnements de test : Experience Platform fournit des environnements de test virtuels qui divisent une instance de plateforme unique en environnements virtuels distincts pour favoriser le développement et l’évolution d’applications d’expérience numérique.

Les sections suivantes fournissent des informations supplémentaires dont vous aurez besoin pour créer une connexion source Blob à l'aide de l'API Flow Service.

Collecte des informations d’identification requises

Pour que Flow Service puisse se connecter à votre enregistrement Blob, vous devez fournir des valeurs pour la propriété de connexion suivante :

Informations d’identification Description
connectionString Chaîne contenant les informations d'autorisation nécessaires pour authentifier Blob auprès de l'Experience Platform. Le modèle de chaîne de connexion Blob est le suivant : DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}. Pour plus d'informations sur les chaînes de connexion, consultez ce Blob document sur la configuration des chaînes de connexion.
sasUri URI de signature d'accès partagé que vous pouvez utiliser comme autre type d'authentification pour connecter votre compte Blob. Le modèle URI SAS Blob est : https://{ACCOUNT_NAME}.blob.core.windows.net/?sv=<storage version>&st={START_TIME}&se={EXPIRE_TIME}&sr={RESOURCE}&sp={PERMISSIONS}>&sip=<{IP_RANGE}>&spr={PROTOCOL}&sig={SIGNATURE}> Pour plus d'informations, consultez ce Blob document sur URI de signature d'accès partagé.
connectionSpec.id Identificateur unique nécessaire pour créer une connexion. L'ID de spécification de connexion pour Blob est : 4c10e202-c428-4796-9208-5f1f5732b1cf

Lecture d’exemples d’appels API

Ce tutoriel fournit des exemples d’appels API pour démontrer comment formater vos requêtes. Il s’agit notamment de chemins d’accès, d’en-têtes requis et de payloads de requêtes correctement formatés. L’exemple JSON renvoyé dans les réponses de l’API est également fourni. Pour plus d’informations sur les conventions utilisées dans la documentation pour les exemples d’appels API, consultez la section sur la lecture d’exemples d’appels API dans le guide de dépannage d’Experience Platform.

Collecte des valeurs des en-têtes requis

Pour lancer des appels aux API Platform, vous devez d’abord suivre le tutoriel sur l’authentification. Le tutoriel sur l’authentification indique les valeurs de chacun des en-têtes requis dans tous les appels API Experience Platform, comme illustré ci-dessous :

  • Authorization: Bearer {ACCESS_TOKEN}
  • x-api-key: {API_KEY}
  • x-gw-ims-org-id: {IMS_ORG}

Toutes les ressources en Experience Platform, y compris celles appartenant à Flow Service, sont isolées dans des sandbox virtuels spécifiques. Toutes les requêtes envoyées aux API Platform nécessitent un en-tête spécifiant le nom de l’environnement de test dans lequel l’opération sera effectuée :

  • x-sandbox-name: {SANDBOX_NAME}

Toutes les requêtes qui contiennent un payload (POST, PUT, PATCH) nécessitent un en-tête de type de média supplémentaire :

  • Content-Type: application/json

Création d’une connexion

Une connexion spécifie une source et contient vos informations d’identification pour cette source. Une seule connexion est requise par compte Blob, car elle peut être utilisée pour créer plusieurs flux de données afin d’importer des données différentes.

Créer une connexion Blob à l'aide de l'authentification basée sur les chaînes de connexion

Pour créer une connexion Blob à l'aide de l'authentification par chaîne de connexion, faites une demande de POST à l'API Flow Service tout en fournissant votre Blob connectionString.

Format d’API

POST /connections

Requête

Pour créer une connexion Blob, l'identifiant de spécification de connexion unique doit être fourni dans le cadre de la demande du POST. L'ID de spécification de connexion pour Blob est 4c10e202-c428-4796-9208-5f1f5732b1cf.

curl -X POST \
    'https://platform.adobe.io/data/foundation/flowservice/connections' \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {IMS_ORG}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}' \
    -H 'Content-Type: application/json' \
    -d '{
        "name": "Azure Blob connection using connectionString",
        "description": "Azure Blob connection using connectionString",
        "auth": {
            "specName": "ConnectionString",
            "params": {
                "connectionString": "DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}"
            }
        },
        "connectionSpec": {
            "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
            "version": "1.0"
        }
    }'
Propriété Description
auth.params.connectionString Chaîne de connexion requise pour accéder aux données dans votre enregistrement Blob. Le modèle de chaîne de connexion Blob est le suivant : DefaultEndpointsProtocol=https;AccountName={ACCOUNT_NAME};AccountKey={ACCOUNT_KEY}.
connectionSpec.id L'ID de spécification de connexion de l'enregistrement Blob est : 4c10e202-c428-4796-9208-5f1f5732b1cf

Réponse

Une réponse réussie renvoie les détails de la connexion nouvellement créée, y compris son identifiant unique (id). Cet identifiant est nécessaire pour explorer votre enregistrement dans le didacticiel suivant.

{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700c57b-0000-0200-0000-5e3b3f440000\""
}

Créer une connexion Blob à l’aide de l’URI de signature d’accès partagé

Un URI de signature de connexion d'accès partagé (SAS) permet une autorisation déléguée sécurisée à votre compte Blob. Vous pouvez utiliser SAS pour créer des informations d'identification d'authentification avec différents degrés d'accès, car une authentification SAS vous permet de définir des autorisations, des dates de début et d'expiration, ainsi que des provisions pour des ressources spécifiques.

Pour créer une connexion Blob à l'aide de l'URI de signature d'accès partagé, envoyez une demande de POST à l'API Flow Service tout en fournissant des valeurs pour votre Blob sasUri.

Format d’API

POST /connections

Requête

curl -X POST \
    'https://platform.adobe.io/data/foundation/flowservice/connections' \
    -H 'Authorization: Bearer {ACCESS_TOKEN}' \
    -H 'x-api-key: {API_KEY}' \
    -H 'x-gw-ims-org-id: {IMS_ORG}' \
    -H 'x-sandbox-name: {SANDBOX_NAME}' \
    -H 'Content-Type: application/json' \
    -d '{
        "name": "Azure Blob source connection using SAS URI",
        "description": "Azure Blob source connection using SAS URI",
        "auth": {
            "specName": "SasURIAuthentication",
            "params": {
                "sasUri": "https://{ACCOUNT_NAME}.blob.core.windows.net/?sv={STORAGE_VERSION}&st={START_TIME}&se={EXPIRE_TIME}&sr={RESOURCE}&sp={PERMISSIONS}>&sip=<{IP_RANGE}>&spr={PROTOCOL}&sig={SIGNATURE}>"
            }
        },
        "connectionSpec": {
            "id": "4c10e202-c428-4796-9208-5f1f5732b1cf",
            "version": "1.0"
        }
    }'
Propriété Description
auth.params.connectionString URI SAS requis pour accéder aux données dans votre enregistrement Blob. Le modèle URI SAS Blob est : https://{ACCOUNT_NAME}.blob.core.windows.net/?sv=<storage version>&st={START_TIME}&se={EXPIRE_TIME}&sr={RESOURCE}&sp={PERMISSIONS}>&sip=<{IP_RANGE}>&spr={PROTOCOL}&sig={SIGNATURE}>.
connectionSpec.id L'ID de spécification de connexion d'enregistrement Blob est : 4c10e202-c428-4796-9208-5f1f5732b1cf

Réponse

Une réponse réussie renvoie les détails de la connexion nouvellement créée, y compris son identifiant unique (id). Cet identifiant est nécessaire pour explorer votre enregistrement dans le didacticiel suivant.

{
    "id": "4cb0c374-d3bb-4557-b139-5712880adc55",
    "etag": "\"1700c57b-0000-0200-0000-5e3b3f440000\""
}

Étapes suivantes

En suivant ce didacticiel, vous avez créé une connexion Blob à l'aide d'API et un identifiant unique a été obtenu dans le corps de la réponse. Vous pouvez utiliser cet ID de connexion pour explorer les enregistrements de cloud à l’aide de l’API Flow Service ou assimiler des données Parquet à l’aide de l’API Flow Service.

Sur cette page