Lakehouse Federation : migrer les connexions de fédération de query héritées

Si vous avez configuré des connexions de fédération de query héritées, Databricks vous recommande de les migrer pour utiliser Lakehouse Federation.

La fédération de requêtes héritée impliquait la création de tables dans Databricks qui référençaient une source de données externe. Pour « déplacer » ces tables vers Unity Catalog à l'aide de Lakehouse Federation, vous devez créer une connexion Lakehouse Federation et un catalogue externe pour la base de données qui inclut la table. Vous pouvez alors accorder l'accès utilisateur au catalogue, ou aux schémas et tables du catalogue, à l'aide de Unity Catalog.

Un seul catalogue étranger peut couvrir plusieurs tables que vous avez configurées pour la fédération de query héritée.

Dans l'exemple suivant :

• La « Legacy syntax » tab affiche la syntaxe utilisée pour créer une table nommée postgresql_table dans Databricks qui fait référence à my-postgres-table dans la base de données my-postgres-database sur le serveur postgres-demo.lb123.us-west-2.rds.amazonaws.com:5432.
• Le « Lakehouse Federation » tab montre la création d'une connexion au serveur postgres-demo.lb123.us-west-2.rds.amazonaws.com:5432, suivie de la création d'un catalogue étranger, my-postgres-catalog qui correspond à la base de données my-postgres-database.

Legacy syntax

SQL

CREATE TABLE postgresql_table
USING postgresql
OPTIONS (
    dbtable 'my-postgres-table',
    host 'postgres-demo.lb123.us-west-2.rds.amazonaws.com',
    port '5432',
    database 'my-postgres-database',
    user 'postgres_user',
    password 'password123'
);

Lakehouse Federation

SQL

--Create a connection:
CREATE CONNECTION postgres-connection TYPE postgresql
OPTIONS (
    host 'postgres-demo.lb123.us-west-2.rds.amazonaws.com',
    port '5432',
    user 'postgres_user',
    password 'password123'
);

--Create a foreign catalog that mirrors the database:
CREATE FOREIGN CATALOG my-postgres-catalog USING CONNECTION postgres-connection
OPTIONS (database 'my-postgres-database');

Le catalogue externe affichera my-postgres-table et toutes les autres tables dans my-postgres-database, et vous pouvez utiliser Unity Catalog pour gérer l'accès à ces tables depuis votre Workspace Databricks.

remarque

Votre configuration de fédération de query d'origine peut inclure des options qui ne sont pas disponibles dans la Lakehouse Federation. Vous n'aurez peut-être pas besoin de ces options lorsque vous passerez à la Lakehouse Federation, mais si vous en avez besoin, vous pouvez continuer à utiliser la connexion de fédération de query héritée plutôt que de migrer.

Des instructions détaillées pour la création de connexions et de catalogues étrangers sont disponibles pour chaque type de connexion pris en charge. Consultez l'article relatif à votre type de connexion, répertorié dans la table des matières du volet de navigation gauche de ce site de documentation.