Utilizzare Google Antigravity per transcodificare ed eseguire la migrazione dei dati

Questa pagina spiega come utilizzare le funzionalità agentiche in Mainframe Connector per transcodificare e migrare automaticamente i dati del mainframe.

Vantaggi principali dell'integrazione agentica

Mainframe Connector supporta una superficie agentica che puoi utilizzare per la modernizzazione dei dati. Puoi utilizzare gli agenti in combinazione con Mainframe Connector per modernizzare i dati del mainframe esistenti in Cloud Storage e in locale. Puoi anche utilizzare ambienti agentici come Google Antigravity per creare le configurazioni di Mainframe Connector necessarie per transcodificare e migrare i dati del mainframe.

Automatizzare la transcodifica e la migrazione dei dati

La scrittura manuale delle configurazioni di transcodifica può essere soggetta a errori e complessa a causa della mancata corrispondenza tra le strutture COBOL legacy (come REDEFINES, COMP-3 e PIC X) e i database cloud moderni (come BigQuery). Questa complessità spesso porta a errori nel mapping dei tipi di dati, nell'allineamento dei byte e nella traduzione dei decimali compressi.

Per semplificare questa procedura, Mainframe Connector supporta le funzionalità agentiche, una suite di strumenti mirati (endpoint API e CLI) e un file di competenzededicato, progettato per l'utilizzo da parte di agenti basati su LLM come Google Antigravity. Questa integrazione consente a un agente di redigere, convalidare rigorosamente, correggere automaticamente e testare i file di configurazione della transcodifica in modo autonomo. L'agente può quindi migrare i dati esistenti da Cloud Storage o da uno spazio di archiviazione locale a BigQuery o ad altri database utilizzando le configurazioni generate.

L'utilizzo delle funzionalità agentiche in Mainframe Connector offre i seguenti vantaggi:

  • Redazione automatica: Google Antigravity può generare la configurazione iniziale in base a un copybook COBOL e a regole aziendali definite dall'utente.
  • Cicli di feedback rapidi: gli strumenti di convalida integrati consentono all'agente di testare rapidamente le configurazioni e correggere automaticamente gli errori prima di elaborare i dati.
  • Ispezione a livello di byte: l'agente può ispezionare i dati binari non elaborati per diagnosticare i problemi di allineamento e codifica.
  • Test deterministici: i comandi leggeri e a thread singolo forniscono un ambiente di test affidabile per il processo di ragionamento dell'agente.

Prima di iniziare

  • Per utilizzare le capacità agentiche, devi installare l'ultima versione di Mainframe Connector. Le capacità agentiche sono disponibili a partire dalla versione 5.20.
  • Per eseguire le competenze dell'agente, devi installare una CLI o un ambiente agentico come Google Antigravity sulla stessa macchina in cui hai installato Mainframe Connector.

  • Estrai il file delle competenze dell'agente nella cartella delle competenze del tuo ambiente con il seguente comando:

    java -jar mainframe-connector.jar agent skill-file --output-dir SKILLS_FOLDER_PATH

Come funziona l'integrazione agentica

Il file delle competenze di Mainframe Connector contiene tutte le informazioni necessarie per consentire a un agente di creare, convalidare e testare il copybook del mainframe e i file di dati della configurazione di transcodifica. Estrae i comandi CLI di Mainframe Connector sottostanti e fornisce un'interfaccia semplificata per l'interazione dell'agente con il prodotto.

Quando richiedi all'agente di utilizzare il file delle competenze, gli consenti di eseguire versioni ottimizzate per l'AI dei comandi di Mainframe Connector. Se fornisci il copybook e i dati di esempio, l'agente può creare il file di configurazione della transcodifica e convalidarlo rispetto ai dati reali. Nella richiesta, assicurati di fornire all'agente il contesto e le regole speciali da applicare nella transcodifica.

Flusso di lavoro agentico

Il flusso di lavoro agentico è composto da cinque fasi, che consentono all'agente di passare dalla richiesta iniziale dell'utente a una configurazione funzionante e convalidata. Dopo la richiesta dell'utente, l'agente può completare autonomamente i seguenti passaggi.

Fase Descrizione
Avvio L'utente richiede all'agente di creare un file di configurazione della transcodifica. L'utente può facoltativamente fornire un copybook COBOL, regole aziendali personalizzate (ad esempio "elimina tutti i campi FILLER") e dati EBCDIC di esempio facoltativi.
Redazione L'agente legge il riferimento configuration-doc per comprendere le regole di formattazione, quindi genera il file di configurazione della bozza.
Convalida L'agente convalida la sintassi e la struttura della bozza eseguendo validate-configuration, correggendo gli errori e verificando il progetto strutturale.
Test Se vengono forniti dati di esempio, l'agente testa la configurazione eseguendo simple-encode o simple-decode e utilizza inspect-data per verificare che l'output corrisponda alle aspettative.
Finalizzazione L'agente genera il DDL di destinazione utilizzando generate-target-ddl, e presenta all'utente la configurazione e il DDL funzionanti.

Casi d'uso

I seguenti esempi illustrano come utilizzare le funzionalità agentiche per transcodificare e migrare i dati.

Esempio 1: generare schemi di dati per BigQuery utilizzando un copybook

La seguente richiesta di esempio mostra come utilizzare le funzionalità agentiche per transcodificare i dati da un copybook del mainframe e generare una tabella BigQuery.

Richiesta di esempio

Your task is to produce a transcode configuration file and target DDL for a
mainframe dataset using the Mainframe Connector skill.

You are migrating a master file from a European subsidiary's mainframe into
BigQuery. Each record holds a customer name, a city, and a price.
The source is an EBCDIC extract from a German z/OS system; the system metadata
gives its CCSID as 1140.

The data is staged here in this directory:

- `copybook.cpy`: the COBOL layout.
- `input.dat`: the binary extract itself (CCSID 1140 - the German Euro-enabled
  EBCDIC code page).

Produce two artifacts here:

1. `config.json`: the transcode configuration that correctly decodes this file.
2. `schema.sql`: the BigQuery `CREATE TABLE` DDL for the destination.

Esempio 2: caricare i dati in BigQuery dopo la transcodifica

La seguente richiesta mostra come utilizzare le funzionalità agentiche per caricare i dati transcodificati dell'esempio precedente in BigQuery.

Richiesta di esempio

Using the Mainframe Connector skill and the config.json and schema.sql files
you created before, migrate the data to BigQuery at
`table_name.dataset_name.project_id`.

Esempio 3: eseguire il deployment in un database PostgreSQL con controlli della privacy

La seguente richiesta mostra come utilizzare le capacità agentiche per eseguire il deployment dei dati transcodificati dell'esempio precedente in PostgreSQL, rimuovendo al contempo i dati PII.

Richiesta di esempio

Using the Mainframe Connector skill, migrate the data to Cloud SQL for
PostgreSQL at `table_name.schema_name.host_name`.

Compliance constraint: `CUST-NAME` and `CITY` are classified as
personally identifying or residency restricted information. They must NOT
appear in the PostgreSQL CSV staging file, must NOT decode into a JSM
string at any point, and must NOT appear in the Postgres table DDL.
Only `PRICE-TEXT` should appear.

Deliverables in the current working directory:

1. `config-postgres.json`: a NEW transcode configuration (do not overwrite
the BigQuery config.json).
2. `schema-postgres.sql`: the PostgreSQL `CREATE TABLE` DDL for the
   destination.
3. `copy-postgres.sql`: the PostgreSQL `COPY FROM` command to load the
   data into the table.

Suite di comandi agentici

I seguenti comandi sono progettati per gli agenti LLM.

agent configuration-doc

Restituisce il documento di configurazione per gli agenti LLM in stdout.

Synopsis

agent configuration-doc [-h]

Flag e argomenti

Il comando agent configuration-doc utilizza i seguenti flag e argomenti:

--help o -h
(Facoltativo) Visualizza questo messaggio di guida.

agent inspect-data

Legge un singolo record logico a partire da un offset di byte specifico, quindi stampa il dump esadecimale e la rappresentazione testuale.

Synopsis

agent inspect-data [-h] [--byte-offset=BYTEOFFSET]
                          --input=INPUTPATH

Flag e argomenti

Il comando agent inspect-data utilizza i seguenti flag e argomenti:

--byte-offset=BYTEOFFSET
(Facoltativo) Specifica l'offset di byte assoluto all'interno del file da cui iniziare la lettura. Il valore predefinito è 0.
--help o -h
(Facoltativo) Visualizza questo messaggio di guida.
--input=INPUTPATH : DataPath
Specifica il percorso dei dati di input.

agent simple-decode

Decodifica alcune righe di un file del mainframe in stdout per il debug dell'agente.

Synopsis

agent simple-decode [-h] [--byte-offset=BYTEOFFSET]
                           --copybook=COPYBOOKPATH
                           --input=INPUTPATH
                           [--limit=LIMIT]
                           [--output=OUTPUTPATH]
                           --transcode-configuration=CONFIGPATH

Flag e argomenti

Il comando agent simple-decode utilizza i seguenti flag e argomenti:

--byte-offset=BYTEOFFSET
(Facoltativo) Specifica l'offset di byte assoluto nel file di input da cui iniziare la lettura. Il valore predefinito è 0.
--copybook=COPYBOOKPATH : DataPath
Specifica il percorso dei dati del copybook.
--help o -h
(Facoltativo) Visualizza questo messaggio di guida.
--input=INPUTPATH : DataPath
Specifica il percorso dei dati di input.
--limit=LIMIT
(Facoltativo) Specifica il numero massimo di record da tentare di decodificare. I record eliminati da record_filter_condition vengono comunque conteggiati ai fini di questo limite. Il valore predefinito è 5.
--output=OUTPUTPATH : DataPath
(Facoltativo) Specifica la destinazione dell'output JSON decodificato. Se non viene fornito, il valore predefinito è stdout.
--transcode-configuration=CONFIGPATH : DataPath
Specifica il percorso dei dati della configurazione della transcodifica. Per ulteriori informazioni sul formato della configurazione del transcodificatore, consulta la configurazione del transcodificatore.

agent simple-encode

Ricodifica un file JSON in dati binari EBCDIC del mainframe.

Synopsis

agent simple-encode [-h] --copybook=COPYBOOKPATH
                           --input=INPUTPATH
                           --output=OUTPUTPATH
                           --transcode-configuration=CONFIGPATH

Flag e argomenti

Il comando agent simple-encode utilizza i seguenti flag e argomenti:

--copybook=COPYBOOKPATH : DataPath
Specifica il percorso dei dati del copybook.
--help o -h
(Facoltativo) Visualizza questo messaggio di guida.
--input=INPUTPATH : DataPath
Specifica il percorso dei dati JSON di input.
--output=OUTPUTPATH : DataPath
Specifica il percorso dei dati binari di output.
--transcode-configuration=CONFIGPATH : DataPath
Specifica il percorso dei dati della configurazione della transcodifica. Per ulteriori informazioni sul formato della configurazione del transcodificatore, consulta la configurazione del transcodificatore.

agent validate-configuration

Convalida una configurazione del transcodificatore rispetto a un copybook e alle regole del database.

Synopsis

agent validate-configuration [-h] --copybook=COPYBOOKPATH
                                    --database=DATABASE
                                    --transcode-configuration=CONFIGPATH

Flag e argomenti

Il comando agent validate-configuration utilizza i seguenti flag e argomenti:

--copybook=COPYBOOKPATH : DataPath
Specifica il percorso dei dati del copybook.
--database=DATABASE
Specifica il database di destinazione (ad es. BIGQUERY, POSTGRES, MYSQL).
--help o -h
(Facoltativo) Visualizza questo messaggio di guida.
--transcode-configuration=CONFIGPATH : DataPath
Specifica il percorso dei dati contenente la bozza della configurazione della transcodifica. Per ulteriori informazioni sul formato della configurazione del transcodificatore, consulta la configurazione del transcodificatore.