Zusammenarbeitsspezifikation¶

Definiert die Zusammenarbeit im Allgemeinen. Die Spezifikation definiert, welche Analyseausführenden eingeladen werden, und für jeden Analyseausführenden, auf welche Daten und Vorlagen er zugreifen und die er ausführen kann. Alle Vorlagen oder Datenangebote, die hier aufgeführt sind, müssen registriert werden, bevor sie in die Zusammenarbeitsspezifikation aufgenommen werden.

Der Eigentümer übermittelt diese Spezifikation durch Aufruf von INITIALIZE.

Schema:

api_version: 2.0.0              # Required: Must be "2.0.0"
spec_type: collaboration        # Required: Must be "collaboration"
name: <collaboration_name>      # Required: Unique name (max 75 chars)
version: <version_string>       # Optional: Version identifier (max 20 chars)
description: <collaboration_description>  # Optional: Description (max 1,000 chars)
owner: <owner_alias>            # Required: Alias of owner

collaborator_identifier_aliases:  # Required: Map aliases to account identifiers
  <alias_1>: <account_identifier_1>  # One or more alias mappings...

analysis_runners:               # Required: Who can run analyses
  <analysis_runner_alias>:      # One or more analysis runner definitions...
    data_providers:             # Required: Data providers for this runner
      <provider_alias>:         # One or more provider definitions...
        data_offerings:         # Required: List of offerings (can be empty [])
          - id: <data_offering_id>  # Zero or more data offering IDs...
    templates:                  # Optional: Templates this runner can use
      - id: <template_id>       # One or more template IDs...
    activation_destinations:    # Optional: Where results can be sent
      snowflake_collaborators:  # Optional: Collaborators who can receive results
        - <collaborator_alias>  # One or more collaborator aliases...

api_version

Die verwendete Version der Collaboration API. Sie müssen 2.0.0 sein.

spec_type

Bezeichner des Spezifikationstyps. Sie müssen collaboration sein.

name: collaboration_name

Benutzerfreundlicher Name für diese Zusammenarbeit. Muss im Konto des Erstellers eindeutig sein und den Regeln für Snowflake-Bezeichner folgen (maximal 75 Zeichen).

version (Optional)

Ein Bezeichner der Version für diese Zusammenarbeit (maximal 20 Zeichen). Muss den Regeln für Snowflake-Bezeichner folgen. Ein geeignetes Format ist YYYY_MM_DD_V#. Beispiel: 2025_10_22_V1.

description: collaboration_description (Optional)

Eine von Menschen lesbare Beschreibung der Zusammenarbeit (maximal 1.000 Zeichen), die von den Teilnehmenden gelesen werden kann.

owner: owner_alias

Alias des Eigentümers der Zusammenarbeit, wie unter collaborator_identifier_aliases definiert.

collaborator_identifier_aliases

Eine Zuordnung von Teilnehmenden-Aliassen zu ihren Data Sharing-Kontenbezeichnern. Nur die hier aufgeführten Benutzenden können an der Zusammenarbeit teilnehmen. Verwenden Sie die hier definierten Aliasse, um auf alle Teilnehmenden zu verweisen, anstatt deren Bezeichner für das Data Sharing-Konto direkt zu verwenden. Muss in dieser Zusammenarbeit eindeutig sein und den Regeln für Snowflake-Bezeichner folgen (maximal 25 Zeichen).

analysis_runners

Beschreibt, wer in dieser Zusammenarbeit eine Analyse durchführen kann. Jeder Analyseausführender ist durch einen eindeutigen Alias kodiert. Sie müssen mindestens einem Konto erlauben, eine Analyse in dieser Zusammenarbeit durchzuführen.

<analysis_runner_alias>

Alias des Kontos, das in dieser Zusammenarbeit eine Analyse durchführen kann. Der Alias ist in der Liste collaborator_identifier_aliases definiert.

data_providers

Datenanbieter, auf deren Daten dieser Analyseausführende zugreifen kann. Jeder Anbieter ist durch den Alias gekennzeichnet, der in collaborator_identifier_aliases definiert ist.

data_offerings

Eine Liste von Datenangeboten dieses Datenanbieters, auf die der Analyseausführende zugreifen kann, oder ein leeres Array [] als Platzhalter, sodass Datenangebote später hinzugefügt werden können. Jedes Datenangebot wird durch seine ID referenziert, die generiert wird, wenn der Datenanbieter REGISTER_DATA_OFFERING aufruft.

templates (Optional)

Die Vorlagen, die von diesem Analyseausführenden verwendet werden können. Jede Vorlage wird durch ihre ID referenziert. Sie können dies in der anfänglichen Spezifikation weglassen und trotzdem Vorlagen für diesen Analyse-Runner freigeben, nachdem die Zusammenarbeit erstellt wurde.

activation_destinations (Optional)

Definiert die Aktivierungseinstellungen für die Analyseergebnisse.

snowflake_collaborators (Optional)

Liste der Teilnehmenden, die aktivierte Analyseergebnisse erhalten können. Verwenden Sie den Alias aus der Liste collaborator_identifier_aliases in dieser Spezifikation. Alle hier aufgeführten Teilnehmenden müssen über die unter Implementierung der Aktivierung beschriebenen Berechtigungen verfügen.

api_version: 2.0.0
spec_type: collaboration
name: my_sample_collaboration
owner: Owner
collaborator_identifier_aliases:
  Owner: ENG.OWNER
  AnalysisRunner_1: ENG.CONSUMER_1
  DataProvider_1: ENG.PROVIDER_1
  DataProvider_2: ENG.PROVIDER_2
  AnalysisRunner_2: ENG.PROVIDER_3
analysis_runners:
  AnalysisRunner_1:
    data_providers:
      DataProvider_1:
        data_offerings:
        - id: DCR_PREPROD_CI_PROVIDER_ANY_NAME_ZUDFTMULHQ_iuDfn_v0
      DataProvider_2:
        data_offerings: []
    templates:
    - id: test_sca_three_party_template_JOaVG_v0
  AnalysisRunner_2:
    data_providers:
      DataProvider_2:
        data_offerings: []
    templates:
    - id: test_sca_three_party_template_JOaVG_v0