Seminar Collibra APIs: REST, GraphQL, Search und Import

APIs verbinden Collibra mit Datenplattformen, Fachanwendungen, Portalen und Automatisierungsstrecken. Eine stabile Integration erfordert jedoch klare Identifikatoren, reproduzierbare Operationen und kontrollierte Fehlerbehandlung.

Die Übungen führen von ersten Lesezugriffen bis zu einer vollständigen Integrationsstrecke. Sicherheits-, Betriebs- und Testanforderungen werden von Beginn an berücksichtigt.

Inhaltsübersicht

1. Tag 1: API-Grundlagen, Authentifizierung und Core-Ressourcen
2. Tag 2: Search, Import und GraphQL
3. Tag 3: Robuste Integrationen und Automatisierung

Zielsetzung

Nach dem Seminar können API-Clients entworfen, Such- und Importvorgänge umgesetzt, komplexe Ressourcenbeziehungen verarbeitet und Integrationen mit Logging, Wiederholungslogik und Tests abgesichert werden.

Zielgruppe

Entwickler, Integrationsarchitekten, Workflow-Entwickler, Plattformadministratoren, DevOps-Teams, technische Data Stewards

Voraussetzungen

Grundkenntnisse in HTTP, JSON und einer Skript- oder Programmiersprache; grundlegende Collibra-Kenntnisse sind hilfreich

Seminarinhalte

Tag 1: API-Grundlagen, Authentifizierung und Core-Ressourcen

1. Schritt 1: API-Landschaft, Anwendungsfälle und Verantwortungsgrenzen der verschiedenen Schnittstellen einordnen.
2. Schritt 2: Sichere Authentifizierung für Benutzer- und Servicezugriffe vorbereiten und testen.
3. Schritt 3: Ressourcen, UUIDs, Public IDs, Asset-Typen und Beziehungen korrekt adressieren.
4. Schritt 4: Lese-, Erstellungs-, Änderungs- und Löschoperationen mit sauberer Validierung ausführen.
5. Schritt 5: Filter, Sortierung, Pagination und Feldselektion für größere Datenmengen einsetzen.
6. Schritt 6: Statuscodes, Fehlermeldungen und Berechtigungsfehler systematisch auswerten.

Tag 2: Search, Import und GraphQL

1. Schritt 1: Suchanforderungen in Filter, Facetten, Wildcards und Ergebnisprojektionen übersetzen.
2. Schritt 2: Komplexe Suchabfragen für Assets, Eigenschaften und Beziehungen entwickeln.
3. Schritt 3: Importbefehle für Communities, Domains, Assets, Attribute und Relationen strukturieren.
4. Schritt 4: Idempotente Massenimporte mit stabilen Identifikatoren und kontrollierten Aktualisierungen aufbauen.
5. Schritt 5: GraphQL-Abfragen für zielgerichtete, verschachtelte Datenabfragen entwerfen.
6. Schritt 6: Import- und Suchergebnisse validieren und Abweichungen reproduzierbar protokollieren.

Tag 3: Robuste Integrationen und Automatisierung

1. Schritt 1: Eine vollständige Integrationsstrecke mit Konfiguration, Secrets und Umgebungsparametern strukturieren.
2. Schritt 2: Wiederholungslogik, Zeitüberschreitungen, Begrenzungen und transiente Fehler behandeln.
3. Schritt 3: Delta-Verarbeitung und Synchronisationszustände nachvollziehbar speichern.
4. Schritt 4: Automatisierte Tests für Datenvertrag, Berechtigungen und fachliche Regeln erstellen.
5. Schritt 5: Protokollierung, Monitoring und Supportinformationen für den Produktivbetrieb definieren.
6. Schritt 6: Eine Beispielintegration vom Quellsystem bis zur geprüften Collibra-Aktualisierung umsetzen.

Praxisanteil

Im Labor entsteht ein lauffähiger API-Client, der Daten sucht, neue Governance-Objekte importiert, bestehende Inhalte aktualisiert und Fehler sowie Wiederholungen nachvollziehbar behandelt.