Referenz zum Collaboration Data Clean Rooms-Schema

Unter diesem Thema werden die Spezifikationsschemas für alle Ressourcen für die Zusammenarbeit beschrieben. Die Spezifikationen werden im YAML-Format dargestellt.

Die Spezifikationen haben ein Feld für die Schemaversion: api_version. Verwenden Sie die hier angezeigte API-Versionsnummer. Unterstützung für frühere Schemaversionen ist nicht garantiert.

Aktuelle Version der DCR Collaboration-API: 2.0.0

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 Definition durch Aufruf von COLLABORATION.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>            # Optional: 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...
Copy
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 (Optional)

Alias oder Data Sharing-Kontobezeichner des Eigentümers der Zusammenarbeit. Wenn nicht angegeben, wird das Konto, das diese Spezifikation registriert, als Eigentümer zugewiesen.

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.

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 []. Wenn Elemente vorhanden sind, hat jedes Element die folgenden Eigenschaften:

  • data_offering_id: Die Referenz-ID für dieses Datenangebot, die generiert wird, wenn der Datenanbieter REGISTRY.REGISTER_DATA_OFFERING aufruft.

templates (Optional)

Die Vorlagen, die von diesem Analyseausführenden verwendet werden können. Jede Vorlage wird durch ihre ID referenziert.

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 Abfrageergebnisse aktivieren beschriebenen Berechtigungen verfügen.

Beispiele

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
Copy

Spezifikation des Datenangebots

Definiert eine Reihe von Tabellen, die ein Anbieter bereit ist, für Analyseausführende freizugeben, sowie Regeln für die Freigabe, wie z. B. Richtlinien, Spaltenformate und ob die Tabelle mit einer Vorlage verwendet werden muss.

Der Datenanbieter übermittelt diese Definition durch Aufruf von REGISTRY.REGISTER_DATA_OFFERING, was eine Freigabeangebots-ID zurückgibt, die in der Zusammenarbeitsdefinition verwendet werden kann.

Ein Datenangebot ist erst dann in einer Zusammenarbeit verfügbar, wenn das Konto, bei dem das Datenangebot registriert wurde, der Zusammenarbeit beitritt.

Sie müssen die Kontoberechtigung REGISTER DATA OFFERING haben, um einer Zusammenarbeit beizutreten, in der Sie Daten aktivieren können; das heißt, Sie sind ein Analysenausführender und die Spezifikation für die Zusammenarbeit enthält ein activation_destinations-Feld. Weitere Informationen dazu finden Sie im Referenzhandbuch für die API-Zugriffsverwaltung.

Schema:

api_version: 2.0.0              # Required: Must be "2.0.0"
spec_type: data_offering        # Required: Must be "data_offering"
name: <data_offering_name>      # Required: Unique name (max 75 chars)
version: <version_string>       # Required: Version identifier (max 20 chars)
description: <data_offering_description>  # Optional: Description (max 1,000 chars)

datasets:                       # Required: Tables to share
  - alias: <dataset_name>       # One or more dataset items...
    data_object_fqn: <database.schema.table_name>  # Required: Fully-qualified table name
    allowed_analyses: <allowed_analysis_type>      # Required: template_only or template_and_freeform_sql
    object_class: <object_class>    # Optional: ads_log or custom
    schema_and_template_policies:   # Required: Column definitions
      <column_name>:                # One or more column definitions...
        category: <category_type>   # Required: join_standard, join_custom, timestamp, or passthrough
        column_type: <format_type>  # Required for join_standard category, omitted for other categories.
        activation_allowed: <true_or_false>  # Optional: Whether column can be used for activation
    freeform_sql_policies:      # Optional: Policies for freeform SQL queries
      aggregation_policy:       # Optional: Single aggregation policy
        name: <fully_qualified_policy_name>
        entity_keys:            # Optional: Entity key columns
          - <column_name>       # One or more column names...
      join_policy:              # Optional: Single join policy
        name: <fully_qualified_policy_name>
        columns:                # Optional: Columns this policy applies to
          - <column_name>       # One or more column names...
      masking_policies:         # Optional: Masking policies
        - name: <fully_qualified_policy_name>  # One or more masking policy items...
          columns:              # Optional: Columns this policy applies to
            - <column_name>     # One or more column names...
      projection_policies:      # Optional: Projection policies
        - name: <fully_qualified_policy_name>  # One or more projection policy items...
          columns:              # Optional: Columns this policy applies to
            - <column_name>     # One or more column names...
      row_access_policy:        # Optional: Row access policies
        - name: <fully_qualified_policy_name>  # One or more row access policy items...
          columns:              # Optional: Columns this policy applies to
            - <column_name>     # One or more column names...
    require_freeform_sql_policy: <true_or_false>  # Optional: Require a policy for freeform SQL
Copy
api_version

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

spec_type

Bezeichner des Spezifikationstyps. Sie müssen data_offering sein.

version

Ein kundenspezifischer Versionsbezeichner für diese Datenangebotsspezifikation (maximal 20 Zeichen). Muss den Regeln für Snowflake-Bezeichner folgen. Die Versionszeichenfolge erhält eine eigene Spalte in der Antwort auf VIEW_DATA_OFFERINGS und VIEW_REGISTERED_DATA_OFFERINGS. Verwenden Sie also einen Wert, der anhand aufsteigender Werte sortiert werden kann. Beispiel: V0

name: data_offering_name

Ein Name für eine Gruppe von Tabellen und Spalten, die für Teilnehmende verfügbar gemacht werden sollen. Dieser Name wird in einer Zusammenarbeitsdefinition als Datenangebots-Referenzwert verwendet. Sie können mehrere Datenangebote mit überlappenden Tabellen und Spalten für verschiedene Anwendungsfälle erstellen. Muss den Regeln für Snowflake-Bezeichner folgen, mit maximal 75 Zeichen, und muss innerhalb Ihres Snowflake Data Clean Room-Kontos eindeutig sein. Das name_version-Paar muss für alle Datenangebote in diesem Konto eindeutig sein.

description: data_offering_description (Optional)

Eine Beschreibung des Datenangebots (maximal 1.000 Zeichen).

datasets

Eine Liste von einem oder mehreren Datasets, die der Zusammenarbeit zur Verfügung gestellt werden sollen.

alias: dataset_name

Ein Name für dieses Datenobjekt, der in collaboration.run`verwendet wird. Muss den :doc:`Regeln für Snowflake-Bezeichner </sql-reference/identifiers-syntax> folgen und innerhalb dieses Angebots eindeutig sein.

data_object_fqn: fully_qualified_table_name

Beschreibt eine einzelne Tabelle, die für Teilnehmende verfügbar ist. Geben Sie den vollqualifizierten Namen des Quellobjekts in Ihrem Konto an (database.schema.table_name). Die maximale Länge beträgt 773 Zeichen.

allowed_analyses: allowed_analysis_type

Der Typ der Analysen, die Teilnehmende für diese Tabelle ausführen können. Erforderliches Feld mit den folgenden Werten:

  • template_only: Der Analyseausführende kann diese Tabelle nur mithilfe einer Vorlage abfragen, die in der Definition der Zusammenarbeit aufgeführt ist.

  • template_and_freeform_sql: Der Analyseausführende kann diese Tabelle entweder mithilfe einer -Vorlage, die in der Zusammenarbeitsdefinition aufgeführt ist, oder mithilfe von Freiform SQL-Abfragen in einer Codeumgebung abfragen.

object_class (Optional)

Typ des Objekts. Einer der folgenden Werte:

  • ads_log: Die hier aufgeführten Tabellen und Spalten müssen den Anforderungen des Ad-Protokolls entsprechen.

  • custom: Ein kundenspezifischer Satz von Tabellen und Spalten, für den keine besonderen Anforderungen gelten.

schema_and_template_policies

Stellen Sie eine Liste der Spaltennamen aus der Tabelle bereit, die von data_object_fqn aufgelistet wird, und definieren Sie die Richtlinien und das Format jeder Spalte. Nur die hier aufgeführten Spalten sind für Teilnehmende verfügbar. Jede Spalte hat die folgenden Deskriptoren:

category: category_type

Die Kategorie bestimmt, ob eine Umbenennung von Spalten angewendet werden soll und welche Durchsetzungsoperationen auf das Datenformat angewendet werden sollen. category und column_type legen den Spaltennamen fest, der für den Analyseausführenden verfügbar ist. Die folgenden Werte werden unterstützt:

  • join_standard: Dies ist eine verknüpfbare Spalte mit Daten in einem Format, das im Feld column_type angegeben ist. Diese Spalte wird in den Wert column_type des freigegebenen Datenangebots umbenannt.

  • join_custom: Dies ist eine verknüpfbare Spalte in einem beliebigen Format. Verwenden Sie dies, wenn es keinen geeigneten column_type für Ihre Verknüpfungsspalte gibt. Der ursprüngliche Spaltenname wird im freigegebenen Datenangebot verwendet.

  • timestamp: Dies ist eine projizierte Spalte, die einen Zeitstempel für ein beliebiges Ereignis angibt. Die Spalte wird im freigegebenen Datenangebot in timestamp umbenannt.

  • passthrough: Dies ist eine projizierte Spalte eines beliebigen anderen Typs. Der ursprüngliche Spaltenname wird im freigegebenen Datenangebot verwendet.

column_type: <format_type> (Erforderlich, wenn die Kategorie gleich join_standard ist; wird bei anderen Kategorietypen ignoriert)

Das Format der Daten. Wenn die Daten nicht mit diesem Format übereinstimmen, schlägt der Aufruf von REGISTER_DATA_OFFERING fehl. Geben Sie dieses Feld für Spalten an, in denen category = join_standard.``category`` und column_type den Spaltennamen festlegen, der für den Analyseausführenden verfügbar ist. Sie können nicht mehreren Spalten in derselben Tabelle den gleichen column_type-Wert zuweisen. Die folgenden Formattypen werden unterstützt:

  • email: Eine unformatierte E-Mail-Adresse.

  • hashed_email_sha256: Eine SHA256-Hash-E-Mail-Adresse.

  • hashed_email_b64_encoded: Eine base64-codierte, gehashte E-Mail-Adresse.

  • phone: Eine Telefonnummer ohne Satzzeichen. Beispiel: 2015551212.

  • hashed_phone_sha256: Eine SHA256-Hash-Telefonnummer. Die ursprüngliche Nummer sollte im Format phone vorliegen.

  • hashed_phone_b64_encoded: Eine base64-codierte, gehashte Telefonnummer.

  • device_id: Eine rohe Geräte-ID, wie z. B. eine Mobilankündigungs-ID oder eine CTV-Geräte-ID.

  • hashed_device_id_sha256: SHA256-Hash-Geräte-ID. Die ursprüngliche ID sollte im device_id-Format vorliegen.

  • hashed_device_b64_encoded: Eine base64-codierte Hash-Geräte-ID.

  • ip_address: Eine rohe IP-Adresse im IPv4-Format.

  • hashed_ip_address_sha256: SHA256-Hash-IPv4-Adresse. Die ursprüngliche ID sollte im ip_address-Format vorliegen.

  • hashed_ip_address_b64_encoded: Eine base64-codierte Hash-IP-Adresse.

activation_allowed (Optional)

Ob diese Spalte für Aktivierungszwecke verwendet werden kann. Standardwert ist false.

freeform_sql_policies (Optional)

Wenn allowed_analyses den Wert template_and_freeform_sql aufweist, werden in diesem optionalen Feld alle Snowflake-Richtlinien aufgelistet, die in Freiform-SQL-Abfragen angewendet werden sollten, die für dieses Datenangebot ausgeführt werden. Weitere Informationen dazu finden Sie unter Anwenden der Richtlinie auf das Datenangebot an (nur Nutzung von Freiform-Abfragen).

Die folgenden Typen werden unterstützt:

aggregation_policy (Optional)

Eine einzelne Konfiguration für eine Aggregationsrichtlinie.

  • name: Der vollqualifizierte Name der Richtlinie.

  • entity_keys (Optional): Liste der Spaltennamen, die als Entitätsschlüssel für die Aggregationsrichtlinie dienen.

join_policy (Optional)

Eine einzelne Konfiguration für eine Verknüpfungsrichtlinie.

  • name: Der vollqualifizierte Name der Richtlinie.

  • columns (Optional): Liste der Spaltennamen, für die diese Richtlinie gilt.

masking_policies (Optional)

Ein Array von Konfigurationen für Maskierungsrichtlinien.

  • name: Der vollqualifizierte Name der Richtlinie.

  • columns (Optional): Liste der Spaltennamen, für die diese Richtlinie gilt.

projection_policies (Optional)

Ein Array von Konfigurationen für Projektionsrichtlinien.

  • name: Der vollqualifizierte Name der Richtlinie.

  • columns (Optional): Liste der Spaltennamen, für die diese Richtlinie gilt.

row_access_policy (Optional)

Ein Array von Konfigurationen für Zeilenzugriffsrichtlinien.

  • name: Der vollqualifizierte Name der Richtlinie.

  • columns (Optional): Liste der Spaltennamen, für die diese Richtlinie gilt.

require_freeform_sql_policy (Optional)

Gibt an, ob für diese Datenquelle freeform_sql_policies definiert sein muss. Dies wird als Failsafe verwendet, um das Hinzufügen einer Datenquelle zu verhindern, die Freiform-SQL-Abfragen unterstützt, ohne ihr Richtlinien zuzuweisen.

Spezifikation der Vorlagenressource

Definiert eine einzelne Vorlage in einer Zusammenarbeit. Wird an REGISTRY.REGISTER_TEMPLATE gesendet, um eine Vorlage zur Verwendung in einer Zusammenarbeit zu registrieren.

Schema:

api_version: 2.0.0              # Required: Must be "2.0.0"
spec_type: template             # Required: Must be "template"
name: <template_name>           # Required: Unique name (max 75 chars)
version: <version_string>       # Required: Version identifier (max 20 chars)
type: <template_type>           # Required: sql_analysis or sql_activation
description: <template_description>  # Optional: High-level description (max 1,000 chars)
methodology: <methodology_description>  # Optional: Detailed description (max 1,000 chars)

parameters:                     # Optional: User-provided parameters
  - name: <parameter_name>      # One or more parameter items...
    description: <parameter_description>  # Optional: Description (max 500 chars)
    required: <true_or_false>   # Optional: Whether required (default: false)
    default: <default_value>    # Optional: Default value
    type: <data_type>           # Optional: String, integer, number, Boolean, array, or object

template: |                     # Required: JinjaSQL template content
  <template_content>
Copy
api_version

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

spec_type

Bezeichner des Spezifikationstyps. Sie müssen template sein.

name

Ein eindeutiger, benutzerfreundlicher Name für diese Vorlage. Dies muss den Snowflake-Bezeichnerregeln folgen und darf maximal 75 Zeichen umfassen. Das name_version-Paar muss für alle Vorlagen in diesem Konto eindeutig sein.

version

Ein Bezeichner der Version für diese Vorlage (maximal 20 Zeichen). Muss den Regeln für Snowflake-Bezeichner folgen. Die Versionszeichenfolge erhält eine eigene Spalte in der Antwort auf VIEW_TEMPLATES und VIEW_REGISTERED_TEMPLATES. Verwenden Sie also einen Wert, der anhand aufsteigender Werte sortiert werden kann. Beispiel: V0

type

Der Vorlagentyp. Einer der folgenden Werte:

  • sql_analysis: Vorlage für Datenanalysevorgänge.

  • sql_activation: Vorlage für Datenaktivierungsvorgänge.

description: template_description (Optional)

Eine allgemeine Beschreibung der Funktion dieser Vorlage (maximal 1.000 Zeichen).

methodology: methodology_description (Optional)

Eine genauere Beschreibung der Funktion dieser Vorlage (maximal 1.000 Zeichen).

parameters (Optional)

Die Liste aller vom Benutzer in dieser Vorlage bereitgestellten Parameter. Jedes Element kann die folgenden Felder haben:

  • name: Parametername als gültiger Snowflake-Bezeichner.

  • description (Optional): Von Menschen lesbare Beschreibung des Parameters (maximal 500 Zeichen).

  • required (Optional): Ob der Parameter erforderlich ist oder nicht Standardwert ist false.

  • default (Optional): Standardwert für den Parameter, der ein beliebiger Datentyp sein kann.

  • type (Optional): Erwarteter Datentyp des Parameters. Einer der folgenden: string, integer, number, boolean, array oder object.

template

Der Inhalt der Vorlage. Für SQL-Vorlagen beinhaltet dies die JinjaSQL-Vorlage. Weitere Informationen dazu finden Sie unter Vorlagenentwurf für eine Zusammenarbeit.

Die Spaltennamen, die der Vorlage angezeigt werden, werden durch die Werte category und column_type für die Spalte in der Datenangebotsdefinition bestimmt. Weitere Informationen dazu finden Sie unter Umbenennen der Quellspalte.

Beispiel:

api_version: 2.0.0
spec_type: template
name: trivial_template
version: V1
type: sql_analysis
description: Simple one-row template.
methodology: Always returns "1". Requires one source table.

parameters:
  - name: row_count
    description: Count of rows
    required: true

template: |
    SELECT 1 FROM IDENTIFIER( {{ source_table[0] }} ) LIMIT {{ row_count }};
Copy

Spezifikation der Analyseanfrage

Gibt alle Informationen an, die Analyseausführende benötigen, um eine Analyse auszuführen, einschließlich der zu verwendenden Vorlage, der Tabellen, die an die Vorlage übergeben werden sollen, und aller von einer Vorlage verwendeten Variablenwerte. Wenn Sie kein Freiform-SQL verwenden, um Daten abzufragen, verwenden alle Analyseausführenden, die eine Analyse ausführen möchten, diese Spezifikation, um die Vorlage und die Eingabedaten zu definieren.

Schema:

api_version: 2.0.0              # Required: Must be "2.0.0"
spec_type: analysis             # Required: Must be "analysis"
template: <template_id>         # Required: ID of the template to use
name: <analysis_name>           # Optional: Unique name (max 75 chars)
version: <version_string>       # Optional: Version identifier (max 20 chars)
description: <analysis_description>  # Optional: Description (max 1,000 chars)

template_configuration:         # Optional: Values used when running the template
  view_mappings:                # Optional: Mappings for shared data
    source_tables:              # Optional: Tables from data offerings. Populates the source_table array variable.
      - <source_table_name>     # One or more source table names...
    <argument_name>: <view_name>  # Custom argument to template view name mapping
  local_view_mappings:          # Optional: Mappings for local data
    my_tables:                  # Optional: Tables from local data offerings. Populates the my_table array variable.
      - <my_table_name>         # One or more local table names...
    <argument_name>: <view_name>  # Custom argument to local template view name mapping
  arguments:                    # Optional: Template arguments as key-value pairs
    <argument_name>: <argument_value>  # One or more argument key-value pairs...
  activation:                   # Required for activation templates
    snowflake_collaborator: <alias>  # Collaborator alias for activation destination
    segment_name: <segment_name>     # Unique segment name for this activation
Copy
api_version

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

spec_type

Bezeichner des Spezifikationstyps. Sie müssen analysis sein.

template: template_name

Die ID der Vorlage, die für diese Analyse verwendet werden soll, wie in einer YAML-Vorlage definiert. Dies muss den Snowflake-Bezeichnerregeln folgen und darf maximal 75 Zeichen umfassen.

name (Optional)

Ein eindeutiger, benutzerfreundlicher Name für diese Analyse. Muss den Regeln für Snowflake-Bezeichner folgen, mit maximal 75 Zeichen, und muss innerhalb Ihres Snowflake Data Clean Room-Kontos eindeutig sein.

version (Optional)

Ein Bezeichner der Version für diese Analysespezifikation (maximal 20 Zeichen). Muss den Regeln für Snowflake-Bezeichner folgen und innerhalb dieses Kontos für diesen Analysenamen eindeutig sein. Ein geeignetes Format ist YYYY_MM_DD_V#. Beispiel: 2025_10_22_V1.

description (Optional)

Eine allgemeine Beschreibung der Funktion dieser Analyse (maximal 1.000 Zeichen).

template_configuration (Optional)

Werte, die beim Ausführen der angegebenen Vorlage verwendet werden.

view_mappings (Optional)

Zuordnen von Argumentnamen zu Namen der Vorlagenansichten für freigegebene Datenangebote.

source_tables (Optional)

Liste der Tabellennamen, die zum Ausfüllen der source_table-Vorlagenvariablen verwendet werden. Verwenden Sie die in der Spezifikation des Datenangebots angegebenen Tabellenaliasse. Sie können eine Liste der verfügbaren Tabellen erhalten, indem Sie COLLABORATION.VIEW_DATA_OFFERINGS aufrufen. Das Format der einzelnen Einträge lautet collaborator alias.data offering ID.dataset alias.

argument_name: view_name

Kundenspezifische Zuordnung eines Argumentnamens zu einem Namen einer Vorlagenansicht (jeweils maximal 255 Zeichen).

local_view_mappings (Optional)

Zuordnung von Argumentnamen zu Namen lokaler Vorlagenansichten für private Datasets.

my_tables (Optional)

Liste der Tabellennamen, die zum Ausfüllen der my_table-Vorlagenvariablen verwendet werden. Dies ist nur für private Datasets verfügbar, die Sie durch den Aufruf von LINK_LOCAL_DATA_OFFERING verknüpft haben. Das Format der einzelnen Einträge lautet collaborator alias.data offering ID.dataset alias.

argument_name: view_name

Kundenspezifische Zuordnung eines Argumentnamens zu einem lokalen Namen einer Vorlagenansicht (jeweils maximal 255 Zeichen).

arguments (Optional)

Vorlagenargumente als Schlüssel-Wert-Paare. Argumentwerte können je nach Vorlagenanforderungen Zeichenfolgen, Zahlen, Boolesche Werte, Arrays oder Objekte sein.

activation (Erforderlich für Aktivierungsvorlagen)

Aktivierungsspezifische Konfiguration erforderlich, wenn Aktivierungsvorlagen ausgeführt werden.

snowflake_collaborator

Teilnehmenden-Alias für das Aktivierungsziel (maximal 25 Zeichen). Muss mit einem im Abschnitt collaborator_identifier_aliases der Zusammenarbeitsspezifikation definierten Alias übereinstimmen, und der Teilnehmende muss im Abschnitt activation_destinations aufgeführt sein.

segment_name

Eindeutiger Segmentname für diese Aktivierung (maximal 255 Zeichen). Wird verwendet, um die Ergebnisse der Aktivierung zu identifizieren und zu verfolgen. Muss den Regeln für Snowflake-Bezeichner folgen.