Data Management:Migrer de DMS MCP vers Agent Data Gateway MCP

Synchroniser les sources de données DMS

Avant d'utiliser le nouveau MCP, synchronisez les sources de données DMS concernées avec Agent Data Gateway. DMS prévoit de synchroniser automatiquement les sources de données existantes pertinentes avec Agent Data Gateway avant le 30 novembre 2026. Pour utiliser le nouveau MCP avant cette date, synchronisez manuellement les sources de données DMS en suivant les étapes ci-dessous :

1. Connectez-vous à la console Agent Data Gateway.

2. Dans le volet de navigation de gauche, sélectionnez Data Sources > Connection Management.

3. Sur la page Connection Management, cliquez sur DMS Instance Sync.

   Remarque

   Vous pouvez également accéder à la page Overview de la console Agent Data Gateway, cliquer sur Get Started, puis sélectionner DMS data source sync dans la section Select Datasource.

4. Sélectionnez les sources de données à utiliser parmi les instances hébergées dans DMS, puis finalisez la synchronisation. Seules les instances DMS hébergées de manière sécurisée peuvent être synchronisées.

Créer une identité d'agent

Avant de vous connecter au MCP et de l'utiliser, créez une identité d'agent en suivant les étapes ci-dessous :

1. Connectez-vous à la console Agent Data Gateway.

2. Dans le volet de navigation de gauche, sélectionnez Identities & Permissions > My Agent Identity, puis cliquez sur Create Agent Identity.

3. Dans la boîte de dialogue qui s'affiche, configurez les paramètres d'identité de l'agent suivants, puis cliquez sur Submit :

   Paramètre	Description
   Name	Saisissez un nom pour l'identité de l'agent.
   AccessToken Expiration Time	Définissez la durée de validité du jeton d'accès de l'agent. Une valeur vide indique que le jeton n'expire jamais.
   Permission Mode	Sélectionnez le mode d'autorisation de l'identité de l'agent : Permissions Follow User : L'agent hérite des autorisations de l'utilisateur actuel en temps réel. Permission Narrowing Mode : Sélectionnez les autorisations de l'agent selon vos besoins, dans la limite des autorisations de l'utilisateur. Independent permissions : L'agent n'hérite pas des autorisations de l'utilisateur actuel. Après la création de l'identité, l'agent obtient les autorisations d'accès aux données via des demandes d'autorisation.

4. Dans la boîte de dialogue, copiez et conservez en toute sécurité le jeton d'accès généré, puis cliquez sur Close. Le jeton d'accès n'est affiché qu'une seule fois lors de sa création et ne peut plus être consulté après la fermeture de la boîte de dialogue.

Se connecter à Agent Data Gateway MCP

Une fois les sources de données synchronisées, connectez-vous au nouveau MCP en utilisant l'une des méthodes suivantes.

Remplacer les outils MCP

Une fois connecté au nouveau MCP, remplacez les anciens outils MCP dans vos applications par les nouveaux. Le tableau suivant répertorie la correspondance et les descriptions entre les principaux outils de l'ancien DMS MCP et ceux du nouveau MCP.

La chaîne de découverte des ressources dans la nouvelle version est unifiée comme suit :

catalogUuid
  → databaseUuid
    → table qualifiedName
      → columns, indexes, or SQL execution

Mise à niveau de l'agent

Ajoutez le contenu suivant à l'invite système ou à l'invite de mise à niveau de votre agent pour l'aider à migrer en douceur vers le nouveau MCP :

You are using Agent Data Gateway MCP. Follow these call rules:

1. Do not call legacy DMS MCP tools such as executeScript, getDatabase,
   getInstance, getTableDetailInfo, listTables, or searchDatabase.

2. The legacy instance is called a catalog in the new version:
   Use meta_catalog_search to locate the instance and obtain the catalogUuid;
   call meta_catalog_get when you need the details.

3. When you query databases:
   - If the catalogUuid is known, call meta_database_list;
   - If only the database name is known, call meta_database_search;
   - After you obtain the databaseUuid, call meta_database_get for the details.

4. When you query tables, use meta_table_list and save the returned qualifiedName.
   To query full table details, call meta_table_columns and
   meta_table_indexes separately.

5. When you execute SQL, use exec_sql:
   - Pass databaseUuid first;
   - Submit only one SQL statement per call;
   - Split multiple SQL statements into multiple sequential calls;
   - If any statement fails, stop the subsequent calls and report the failure;
   - Do not claim that multiple calls have transaction atomicity or are automatically rolled back.

6. When exec_sql returns NEEDS_CONFIRMATION, the user must review it first,
   and then retry with the confirm reason; do not skip confirmation by default.

7. List tools use NextToken cursor-based pagination. When hasMore=true,
   pass the returned NextToken as-is to get the next page instead of using legacy page-number pagination.

8. A visible data source does not mean that execution permission is granted. When ACCESS_DENIED occurs,
   remind the user to check the agent identity and instance authorization, and do not retry the SQL repeatedly.

Considérations pour le remplacement de executeScript

Dans les scénarios de bases de données physiques, l'ancien outil executeScript pouvait recevoir plusieurs instructions SQL et les exécuter séquentiellement, mais il ne garantissait pas l'atomicité des transactions pour l'ensemble du script. Dans les scénarios de bases de données logiques, une seule instruction SQL était autorisée. Le nouvel outil exec_sql ne prend actuellement en charge qu'une seule instruction SQL et ne permet pas l'exécution par lot de plusieurs instructions. Respectez les règles suivantes lors de la mise à niveau :

• Divisez plusieurs instructions SQL en plusieurs appels exec_sql.

• Exécutez les instructions une par une, dans l'ordre du script d'origine.

• Si une instruction échoue, arrêtez les appels suivants et signalez l'échec.

• Ne prétendez pas que plusieurs appels sont automatiquement annulés (rollback) ou possèdent une atomicité transactionnelle.

• Lorsque NEEDS_CONFIRMATION est renvoyé, effectuez une révision manuelle, puis réessayez avec la raison confirm.

• L'ancien paramètre logic ne correspond à aucun nouveau paramètre. La ressource cible est exprimée par le nouveau paramètre databaseUuid. Les bases de données logiques qui ne sont pas encore connectées à la passerelle ne peuvent pas être mises à niveau directement.

Exemple d'appel avec une seule instruction SQL :

{
  "name": "exec_sql",
  "arguments": {
    "databaseUuid": "<database-uuid>",
    "statement": "SELECT id, status FROM orders LIMIT 20",
    "maxRows": 100,
    "waitSeconds": 110
  }
}

Exemple de remplacement de meta_table_list

L'ancien outil getTableDetailInfo est remplacé par deux requêtes : meta_table_columns et meta_table_indexes. Obtenez d'abord le qualifiedName de la table en utilisant meta_table_list, puis interrogez séparément les colonnes et les index :

{"name":"meta_table_columns","arguments":{"databaseUuid":"<database-uuid>","tableQualifiedName":"trade.orders"}}
{"name":"meta_table_indexes","arguments":{"databaseUuid":"<database-uuid>","tableQualifiedName":"trade.orders"}}

Les deux résultats constituent ensemble le résultat métier de l'ancien outil getTableDetailInfo.