INSERT (SQL-Graph)

Gilt für: SQL Server 2017 (14.x) und höhere Versionen von Azure SQL-DatenbankAzure SQL Managed InstanceSQL sql database in Microsoft Fabric

Fügt einer node- oder edge-Tabelle in SQL Server mindestens eine Zeile hinzu.

Transact-SQL-Syntaxkonventionen

INSERT Syntax der Knotentabelle

Die Syntax für das Einfügen in eine Knotentabelle entspricht der einer regulären Tabelle.

[ WITH <common_table_expression> [ ,...n ] ]  
INSERT   
{  
        [ TOP ( expression ) [ PERCENT ] ]   
        [ INTO ]   
        { <object> | rowset_function_limited   
          [ WITH ( <Table_Hint_Limited> [ ...n ] ) ]  
        }  
    {  
        [ (column_list) ] | [(<edge_table_column_list>)]  
        [ <OUTPUT Clause> ]  
        { VALUES ( { DEFAULT | NULL | expression } [ ,...n ] ) [ ,...n     ]   
        | derived_table   
        | execute_statement  
        | <dml_table_source>  
        | DEFAULT VALUES   
        }  
    }  
}  
[;]  
  
<object> ::=  
{   
    [ server_name . database_name . schema_name .   
      | database_name .[ schema_name ] .   
      | schema_name .   
    ]  
    node_table_name  | edge_table_name
}  
  
<dml_table_source> ::=  
    SELECT <select_list>  
    FROM ( <dml_statement_with_output_clause> )   
      [AS] table_alias [ ( column_alias [ ,...n ] ) ]  
    [ WHERE <on_or_where_search_condition> ]  
        [ OPTION ( <query_hint> [ ,...n ] ) ]  

<on_or_where_search_condition> ::=
    {  <search_condition_with_match> | <search_condition> }

<search_condition_with_match> ::=
    { <graph_predicate> | [ NOT ] <predicate> | ( <search_condition> ) }
    [ AND { <graph_predicate> | [ NOT ] <predicate> | ( <search_condition> ) } ]
    [ ,...n ]

<search_condition> ::=
    { [ NOT ] <predicate> | ( <search_condition> ) }
    [ { AND | OR } [ NOT ] { <predicate> | ( <search_condition> ) } ]
    [ ,...n ]

<graph_predicate> ::=
    MATCH( <graph_search_pattern> [ AND <graph_search_pattern> ] [ , ...n] )

<graph_search_pattern>::=
    <node_alias> { { <-( <edge_alias> )- | -( <edge_alias> )-> } <node_alias> }

<edge_table_column_list> ::=
    ($from_id, $to_id, [column_list])

Arguments

INTO

Ein optionales Schlüsselwort, das zwischen INSERT und der Zieltabelle verwendet werden kann.

MATCH search_condition_with_match Klausel kann in einer Unterabfrage verwendet werden, während sie in einen Knoten oder eine Randtabelle eingefügt wird. Informationen zur Anweisungssyntax finden Sie unter GRAPH MATCH (Transact-SQL).For MATCH statement syntax, see GRAPH MATCH (Transact-SQL).

graph_search_pattern Suchmuster, das als MATCH Teil des Graph-Prädikats bereitgestellt wird.

edge_table_column_list Benutzer müssen Werte für $from_id und $to_id beim Einfügen in einen Rand bereitstellen. Ein Fehler wird zurückgegeben, wenn kein Wert angegeben wird oder NULLs in diese Spalten eingefügt werden.

Remarks

• Das Einfügen in eine Knotentabelle entspricht dem Einfügen in eine relationale Tabelle. Werte für die $node_id Spalte werden automatisch generiert.
• Während Sie Zeilen in eine Randtabelle einfügen, müssen Sie Werte für $from_id und $to_id Spalten angeben.
• Masseneinfügung in Knotentabellen entspricht der Masseneinfügung in eine relationale Tabelle.
• Vor der Masseneinfügung in eine Edgetabelle müssen die Knotentabellen importiert werden. Anschließend können Werte für $from_id und $to_id aus der $node_id-Spalte der Knotentabelle extrahiert werden und als Edges eingefügt werden.
• In der Fabric SQL-Datenbank ist SQL Graph zulässig, aber Knoten- und Edgetabellen spiegeln sich nicht in Fabric OneLake.

Permissions

INSERT Für die Zieltabelle ist eine Erlaubnis erforderlich.

INSERT Die Berechtigungen werden standardmäßig auf Mitglieder der Sysadmin-Fixed-Server-Rolle , die db_owner und db_datawriter Fixed-Datenbankrollen sowie den Tabellenbesitzer übertragen. Mitglieder der Rollen sysadmin, db_owner und db_securityadmin sowie der Tabellenbesitzer können Berechtigungen an andere Benutzer übertragen.

Um mit der OPENROWSET-Funktion BULK-Option auszuführen INSERT , musst du Mitglied der Sysadmin-Fixed-Server-Rolle oder der Bulkadmin-Fixed-Server-Rolle sein.

Examples

A. Einfügen in Knotentabellen

Im folgenden Beispiel wird eine Person Knotentabelle erstellt und zwei Zeilen in diese Tabelle eingefügt.

-- Create person node table
CREATE TABLE dbo.Person (ID integer PRIMARY KEY, name varchar(50)) AS NODE;
 
-- Insert records for Alice and John
INSERT INTO dbo.Person VALUES (1, 'Alice');
INSERT INTO dbo.Person VALUES (2,'John');

B. Einfügen in Edgetabellen

Im folgenden Beispiel wird eine friend Randtabelle erstellt und eine Kante in die Tabelle eingefügt.

-- Create friend edge table
CREATE TABLE dbo.friend (start_date DATE) AS EDGE;

-- Create a friend edge, that connect Alice and John
INSERT INTO dbo.friend VALUES ((SELECT $node_id FROM dbo.Person WHERE name = 'Alice'),
        (SELECT $node_id FROM dbo.Person WHERE name = 'John'), '9/15/2011');

Nächste Schritte

• Graphenverarbeitung
• Erstellen einer Diagrammdatenbank und Ausführen einiger Musterabgleichsabfragen mithilfe von T-SQL
• INSERT TABLE (Transact-SQL)
• SHORTEST_PATH (Transact-SQL)