Vorbereitende Schritte

Sie müssen wie folgt vorgehen:

• Sie haben die JAR-Datei(en) des Plugins (im Format PF4J ).

• Eine Richtlinienzuordnungsdatei, die die Zuordnung der Plugins definiert, die für die entsprechenden Richtlinienmodule ausgeführt werden sollen.

Zugriff auf das CPG-Paket

1. Klonen Sie die neueste Version des leichtgewichtigen CPG-Pakets von : CPG-Paket.

2. Nach dem Klonen können Sie die folgende Ordnerstruktur sehen:

   
   CPG-Plugin-Runner/
   ├─ CPG-Plugin-Runner-1.0.0.jar      # The executable runner
   ├─ plugins/                         # Place your plugin JARs here
   │  └─ <your-plugin>.jar
   ├─ config/
      └─ plugin-resource-mapping.yaml  # Maps resource names to plugin IDs
   ├─ plugin-templates
      └─ java-access-plugin            # sample plugin project
         ├─ src
         └─ resources
            └─ plugin.properties
   

   Sie können Ordner nach Bedarf umbenennen oder verschieben.

Das Paket enthält Folgendes:

• CPG-Plugin-Runner-1.0.0.jar: Das ausführbare Connector-JAR, das Ihre Plugins lädt und ausführt.

• plugins/: Verzeichnis, in dem Sie Ihre benutzerdefinierten Plugin-JARs ablegen.

• plugin-resource-mapping.yaml: Konfigurationsdatei, die die Ressourcen von watsonx.data den Plugin-IDs der Policy Engine zuordnet. Nachfolgend finden Sie ein Beispiel für die Website plugin-resource-mapping.yaml.

plugin-mapping:
  java-access-plugin:
    - iceberg
  ranger-access-plugin:
    - iceberg
    - hive_data
  python-access-plugin:
    - hive_data

Parameter, die in der Konfigurationsdatei erforderlich sind:

• Schlüssel: Der Name der Ressource watsonx.data (Beispiel hive_data).

• Werte: Plugin-IDs, die in der Datei plugin.properties des jeweiligen Plugins definiert sind. Beispiel: plugin.id=java-access-plugin. Die ID muss genau übereinstimmen.

Erstellung eines Plugins (aus einer Vorlage) und Konfiguration von YAML

Um sich mit der gewünschten Policy Engine Ihrer Wahl zu verbinden, müssen Sie ein Plugin (JAR-Datei) erstellen, das gegen die bereits in cpg.jar eingebetteten API-Typen kompiliert. Das heruntergeladene CPG-Paket enthält ein Plugin-Vorlagenprojekt. Sie können die Vorlage verwenden und eine neue Vorlage für Ihre Zwecke erstellen. Zusätzliche Abhängigkeiten sind nicht erforderlich.

1. Entpacken Sie die Vorlagendatei.

2. Aktualisieren Sie die Datei, damit sie die neueste CPG jar-Datei enthält.

3. Führen Sie den folgenden Befehl aus:

   cd java-access-plugin
   mvn -DskipTests clean package
   

   Ihr JAR wird generiert unter: target/<your-plugin>.jar.

4. Kopieren Sie die JAR-Datei in den Ordner plugins/ des CPG-Connectors.

5. Aktualisieren Sie plugin-resource-mapping.yaml, um auf Ihre Plugin-ID zu verweisen.

   Optional :Um Zeilen-/Spalten-Transformationen zurückzugeben, setzen Sie sie mit: result.setTransformColumns(...); result.setTransformRows(...);

Laufender CPG-Anschluss

1. Führen Sie die JAR-Datei des CPG-Connectors über das Terminal aus, indem Sie den Befehl 'java -jar cpg.jar '.

   Dabei wird der folgende Standardpfad für Plugins und die Konfigurationsdatei verwendet.

   • plugins/ :./plugins
   • config/ :. /config/plugin-resource-mapping.yaml

   Sie können den Pfad auch mit dem folgenden Befehl anpassen:

   java -jar cpg.jar <absolute/path/to/plugins> <absolute/path/to/config/plugin-resource-mapping.yaml>.

   Im Folgenden wird die interaktive Beispielsitzung angezeigt:

   
   Enter username : admin
   Enter resource_name (e.g., hive_data) or 'quit': hive_data
   Enter resource_type (e.g., table): table
   Enter actions (comma-separated, e.g., select,insert): select
   
   [Runner] Params: user=admin, resource=hive_data, type=table, actions=[select]
   [Runner] Plugins to run: [java-access-plugin]
   ======Result======
   {
     "status" : "SUCCESS",
     "error" : null,
     "plugin_id" : "java-access-plugin",
     "resources" : [ {
       "actions" : [ "select" ],
       "resource_name" : "hive_data",
       "resource_type" : "table",
       "actions_result" : [ {
         "select" : "true"
       } ],
       "transform_columns" : null,
       "transform_rows" : null
     } ]
   }
   =================
   
   

2. Geben Sie quit oder exit ein, um zu beenden.

Fehlerbehebung

Bekannte Beschränkungen:

Der CPG-Steckverbinder hat die folgenden Einschränkungen:

• Derzeit werden nur PF4J-based Plugins unterstützt.

• Es gibt keine Benutzeroberfläche. Ausführung über die Befehlszeilenschnittstelle.

• Die Pfadauflösung kann je nach Betriebssystemumgebung variieren.