.create-or-alter graph_model (förhandsversion)

2025-06-05

Gäller för: ✅Microsoft Fabric✅Azure Data Explorer

Anmärkning

Den här funktionen är för närvarande i offentlig förhandsversion. Funktioner och syntax kan komma att ändras före allmän tillgänglighet.

Skapar en ny grafmodell eller ändrar en befintlig med hjälp av den angivna modellens definitionsnyttolast.

Behörigheter

Om du vill köra det här kommandot behöver användaren behörigheter för databasanvändare.

Syntax

.create-or-alter graph_model GraphModelNameGraphModelDefinitionPayload

Parameterar

Namn	Typ	Krävs	Beskrivning
GraphModelName	Sträng	✅	Namnet på grafmodellen som ska skapas eller ändras. Namnet måste vara unikt i databasen och följa namngivningsreglerna för entiteten.
GraphModelDefinitionPayload	Sträng	✅	Ett giltigt JSON-dokument som definierar grafmodellen. Se Diagrammodelldefinitionsnyttolast.

Nyttolast för diagrammodelldefinition

Diagrammodellens definitionsnyttolast är ett JSON-dokument som definierar strukturen och bearbetningsstegen för grafmodellen. Detaljerad information om diagrammodellens definitionsformat finns i Översikt över grafmodell.

Retur

Det här kommandot returnerar en tabell med följande kolumner:

Kolumn	Typ	Beskrivning
Namn	Sträng	Namnet på grafmodellen som skapades eller ändrades.
CreationTime	Datum och tid	Tidsstämpeln när grafmodellen skapades eller ändrades.
ID	Sträng	Den unika identifieraren för grafmodellen.
SnapshotsCount	Int	Antalet ögonblicksbilder som skapats från den här grafmodellen.
Modell	Sträng (JSON)	JSON-definitionen för grafmodellen, inklusive schema- och bearbetningssteg.
AuthorizedPrincipals	Sträng (JSON)	Matris med huvudnamn som har åtkomst till grafmodellen, inklusive deras identifierare och rolltilldelningar.
Policy för kvarhållande	Sträng (JSON)	Den kvarhållningsprincip som konfigurerats för grafmodellen.

Exempel

Skapa en ny grafmodell

.create-or-alter graph_model SocialNetwork ```
{
    "Schema": {
        "Nodes": {
            "User": {
                "UserId": "string",
                "Username": "string",
                "JoinDate": "datetime",
                "IsActive": "bool"
            }
        },
        "Edges": {
            "Follows": {
                "Since": "datetime"
            },
            "Likes": {
                "Timestamp": "datetime",
                "Rating": "int"
            }
        }
    },
    "Definition": {
        "Steps": [
            {
                "Kind": "AddNodes",
                "Query": "Users | project UserId, Username, JoinDate, IsActive",
                "NodeIdColumn": "UserId",
                "Labels": ["User"]
            },
            {
                "Kind": "AddEdges",
                "Query": "FollowEvents | project SourceUser, TargetUser, CreatedAt",
                "SourceColumn": "SourceUser",
                "TargetColumn": "TargetUser",
                "Labels": ["Follows"]
            },
            {
                "Kind": "AddEdges",
                "Query": "LikeEvents | project UserId, ContentId, Timestamp, Score",
                "SourceColumn": "UserId",
                "TargetColumn": "ContentId",
                "Labels": ["Likes"]
            }
        ]
    }
}
```

Resultat

Namn	Skapandetid	ID-nummer	SnapshotsCount	Modell	AuthorizedPrincipals	Bevarandeprincip
SocialNetwork	2025-05-23 14:42:37.5128901	aaaaaaaaa-0b0b-1c1c-2d2d-3333333333333333	0	modell ovanifrån	[ { "Type": "Microsoft Entra ID User", "DisplayName": "Alex Johnson (upn: alex.johnson@contoso.com)", "ObjectId": "aaaaaaaaaa-bbbb-cccc-1111-22222222222", "FQN": "aaduser=aaaaaaaa-bbbb-cccc-1111-2222222222222; aaaabbbb-0000-cccc-1111-dddd222eeee", "Notes": "", "RoleAssignmentIdentifier": "a0a0a0a0-bbbb-cccc-ddddd-e1e1e1e1e1e1e1" } ]	{ "SoftDeletePeriod": "3650.00:00:00" }

Noteringar

Om det inte finns någon grafmodell med det angivna namnet skapas en ny när du använder .create-or-alter graph_model. Om det redan finns en sådan uppdateras den med den nya definitionen.
Varje gång en grafmodell ändras skapas en ny version, så att du kan spåra ändringar över tid och återgå till tidigare versioner om det behövs.
Om du vill generera en grafögonblicksbild från modellen använder du .make graph_snapshot kommandot .