Erstellen eines ML-Eingabekanals in AWS Clean Rooms ML

Voraussetzungen:

• Und AWS-Konto mit Zugriff auf AWS Clean Rooms

• Eine Zusammenarbeit, AWS Clean Rooms in der Sie den ML-Eingangskanal erstellen möchten

• Berechtigungen zum Abfragen von Daten und zum Erstellen von ML-Eingabekanälen in der Kollaboration.

• (Optional) Ein vorhandener Modellalgorithmus, der dem ML-Eingabekanal zugeordnet werden soll, oder Berechtigungen zum Erstellen eines neuen

• (Optional) Tabellen mit Analyseregeln, die für das angegebene Modell ausgeführt werden können.

• (Optional) Eine vorhandene SQL-Abfrage- oder Analysevorlage, die für die Generierung des Datensatzes verwendet werden soll

• (Optional) Eine vorhandene Servicerolle mit entsprechenden Berechtigungen oder Berechtigungen zum Erstellen einer neuen Servicerolle

• (Optional) Ein benutzerdefinierter AWS KMS Schlüssel, wenn Sie Ihren eigenen Verschlüsselungsschlüssel verwenden möchten

• Entsprechende Berechtigungen zum Erstellen und Verwalten von ML-Modellen in der Zusammenarbeit

Ein ML-Eingabekanal ist ein Datensatz, der anhand einer bestimmten Datenabfrage erstellt wird. Mitglieder mit der Fähigkeit, Daten abzufragen, können ihre Daten für Training und Inferenz vorbereiten, indem sie einen ML-Eingabekanal erstellen. Durch die Erstellung eines ML-Eingangskanals können diese Daten in verschiedenen Trainingsmodellen innerhalb derselben Zusammenarbeit verwendet werden. Sie sollten separate ML-Eingangskanäle für Training und Inferenz erstellen.

Um einen ML-Eingabekanal zu erstellen, müssen Sie die SQL-Abfrage angeben, die zur Abfrage der Eingabedaten verwendet wird, und den ML-Eingabekanal erstellen. Die Ergebnisse dieser Abfrage werden niemals an ein Mitglied weitergegeben und bleiben innerhalb der Grenzen von Clean Rooms ML. Die Referenz Amazon Resource Name (ARN) wird in den nächsten Schritten verwendet, um ein Modell zu trainieren oder Inferenz auszuführen.

Console

Um einen ML-Eingangskanal (Konsole) zu erstellen

1. Melden Sie sich bei https://console.aws.amazon.com/cleanrooms an AWS Management Console und öffnen Sie die AWS Clean Rooms Konsole.

2. Wählen Sie im linken Navigationsbereich Collaborations aus.

3. Wählen Sie auf der Seite Collaborations die Kollaboration aus, für die Sie einen ML-Eingabekanal erstellen möchten.

4. Wählen Sie nach dem Öffnen der Kollaboration die Registerkarte ML-Modelle aus.

5. Wählen Sie unter Benutzerdefinierte ML-Modelle im Abschnitt ML-Eingangskanäle die Option ML-Eingangskanal erstellen aus.

6. Gehen Sie auf der Seite „ML-Eingangskanal erstellen“ für Details zum ML-Eingangskanal wie folgt vor:

   1. Geben Sie unter Name einen eindeutigen Namen für Ihren Kanal ein.

   2. (Optional) Geben Sie unter Beschreibung eine Beschreibung Ihres Kanals ein.

   3. Wählen Sie unter Assoziierter Modellalgorithmus den zu verwendenden Algorithmus aus.

      Wählen Sie Modellalgorithmus zuordnen aus, um einen neuen Modellalgorithmus hinzuzufügen.

7. Wählen Sie für Datensatz eine Methode zum Generieren des Trainingsdatensatzes aus:

   • Wählen Sie SQL-Abfrage, um die Ergebnisse einer SQL-Abfrage als Trainingsdatensatz zu verwenden.

     Wenn Sie SQL-Abfrage gewählt haben, geben Sie Ihre Abfrage in das SQL-Abfragefeld ein.

     (Optional) Um eine Abfrage zu importieren, die Sie kürzlich verwendet haben, wählen Sie Aus letzten Abfragen importieren aus.

   • Wählen Sie Analysevorlage, um die Ergebnisse einer Analysevorlage als Trainingsdatensatz zu verwenden.

     Wenn Sie Analysevorlage ausgewählt haben, geben Sie die gewünschte Analysevorlage an.

   1. Wenn keine Tabellen verknüpft sind, wählen Sie Tabelle zuordnen aus, um Tabellen mit einer Analyseregel hinzuzufügen, die für das angegebene Modell ausgeführt werden kann.

   2. Wählen Sie unter Mitarbeitertyp den Typ der Arbeitskraft aus, die Sie verwenden möchten. Die Standardeinstellung ist CR.1X.

   3. Wählen Sie unter Anzahl der Mitarbeiter die Anzahl der Mitarbeiter aus, die bei der Erstellung dieses Datenkanals verwendet werden sollen. Die Standardeinstellung ist 16.

   4. Geben Sie für Datenspeicherung in Tagen die Anzahl der Tage ein, für die die Daten aufbewahrt werden sollen.

   5. Wählen Sie als Ergebnisformat entweder CSV oder Parquet als Datenformat, das der ML-Eingabekanal verwenden soll.

8. Wählen Sie für Dienstzugriff den Namen der vorhandenen Servicerolle aus, der für den Zugriff auf diese Tabelle verwendet werden soll, oder wählen Sie Neue Servicerolle erstellen und verwenden aus.

9. Wählen Sie für Verschlüsselung das Verschlüsselungsgeheimnis mit einem benutzerdefinierten KMS-Schlüssel aus, um Ihren eigenen KMS-Schlüssel und zugehörige Informationen anzugeben. Andernfalls verwaltet Clean Rooms ML die Verschlüsselung.

10. Wählen Sie „ML-Eingangskanal erstellen“.

    Die Erstellung des ML-Eingangskanals dauert einige Minuten. Auf der Registerkarte ML-Eingabe finden Sie eine Liste der ML-Eingangskanäle.

Anmerkung

Nachdem der ML-Eingangskanal erstellt wurde, können Sie ihn nicht mehr bearbeiten.

API

Um einen ML-Eingangskanal (API) zu erstellen

Führen Sie den folgenden Code mit Ihren spezifischen Parametern aus:

import boto3 
acr_client = boto3.client('cleanroomsml')

acr_client.create_ml_input_channel(
    name="ml_input_channel_name",
    membershipIdentifier='membership_id',
    configuredModelAlgorithmAssociations=[configured_model_algorithm_association_arn],
    retentionInDays=1,
    inputChannel={
        "dataSource": {
            "protectedQueryInputParameters": {
                "sqlParameters": {
                    "queryString": "select * from table"
                "computeConfiguration": {
                    "worker": {
                          "type": "CR.1X",
                          "number": 16
                        }
                    },
                "resultFormat": "PARQUET"
                }
            }
        },
        "roleArn": "arn:aws:iam::111122223333:role/ezcrc-ctm-role"
    }
)
channel_arn = resp['ML Input Channel ARN']