MATCH (Transact-SQL)

Dotyczy: SQL Server 2017 (14.x) i nowsze wersje bazy danychSQL Sql Database azure SQLDatabasew usłudze Microsoft Fabric

Określa warunek wyszukiwania grafu. Funkcja MATCH może być używana tylko z tabelami węzłów grafu i krawędzi w instrukcji SELECT w ramach klauzuli WHERE.

Transact-SQL konwencje składni

Syntax

MATCH (<graph_search_pattern>)

<graph_search_pattern>::=
  {
      <simple_match_pattern>
    | <arbitrary_length_match_pattern>
    | <arbitrary_length_match_last_node_predicate>
  }

<simple_match_pattern>::=
  {
      LAST_NODE(<node_alias>) | <node_alias>   {
          { <-( <edge_alias> )- }
        | { -( <edge_alias> )-> }
        <node_alias> | LAST_NODE(<node_alias>)
        }
  }
  [ { AND } { ( <simple_match_pattern> ) } ]
  [ , ...n ]

<node_alias> ::=
  node_table_name | node_table_alias

<edge_alias> ::=
  edge_table_name | edge_table_alias

<arbitrary_length_match_pattern>  ::=
  {
    SHORTEST_PATH(
      <arbitrary_length_pattern>
      [ { AND } { <arbitrary_length_pattern> } ]
      [ , ...n ]
    )
  }

<arbitrary_length_match_last_node_predicate> ::=
  {  LAST_NODE( <node_alias> ) = LAST_NODE( <node_alias> ) }

<arbitrary_length_pattern> ::=
    {  LAST_NODE( <node_alias> )   | <node_alias>
     ( <edge_first_al_pattern> [ <edge_first_al_pattern>... , n ] )
     <al_pattern_quantifier>
  }
     |  ( { <node_first_al_pattern> [ <node_first_al_pattern> ... , n ] )
            <al_pattern_quantifier>
        LAST_NODE( <node_alias> ) | <node_alias>
 }

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

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

<al_pattern_quantifier> ::=
  {
        +
      | { 1 , n }
  }

n -  positive integer only.

Arguments

graph_search_pattern

Określa wzorzec wyszukiwania lub ścieżki do przechodzenia w grafie. Ten wzorzec używa składni sztuki ASCII do przechodzenia ścieżki na grafie. Wzorzec przechodzi od jednego węzła do drugiego za pośrednictwem krawędzi w kierunku podanej strzałki. Nazwy krawędzi lub aliasy są udostępniane wewnątrz nawiasów. Nazwy węzłów lub aliasy są wyświetlane na dwóch końcach strzałki. Strzałka może przechodzić w obu kierunkach we wzorcu.

node_alias

Nazwa lub alias tabeli węzłów podana w klauzuli FROM.

edge_alias

Nazwa lub alias tabeli krawędzi podanej w klauzuli FROM.

SHORTEST_PATH

Najkrótsza funkcja path służy do znajdowania najkrótszej ścieżki między dwoma węzłami na grafie lub między danym węzłem a wszystkimi innymi węzłami na grafie. Przyjmuje on dowolny wzorzec długości jako dane wejściowe, który jest wyszukiwany wielokrotnie na grafie. Wprowadzono w programie SQL Server 2019. Wymaga programu SQL Server 2019 lub nowszego.

arbitrary_length_match_pattern

Określa węzły i krawędzie, które należy przechodzić wielokrotnie do momentu osiągnięcia żądanego węzła lub do momentu osiągnięcia maksymalnej liczby iteracji określonych we wzorcu.

al_pattern_quantifier

Wzorzec dowolnej długości przyjmuje kwantyfikatory stylu wyrażenia regularnego w celu określenia liczby powtórzeń danego wzorca wyszukiwania. Obsługiwane kwantyfikatory wzorca wyszukiwania to:

• +: Powtórz wzorzec 1 lub więcej razy. Po znalezieniu najkrótszej ścieżki zakończ działanie.
• {1,n}: powtórz wzorzec 1, aby n razy. Po znalezieniu najkrótszej ścieżki zakończ działanie.

Remarks

Nazwy węzłów wewnątrz funkcji MATCH można powtórzyć. Innymi słowy, węzeł można przechodzić dowolną liczbę razy w tym samym zapytaniu.
Nie można powtórzyć nazwy krawędzi wewnątrz funkcji MATCH.
Krawędź może wskazywać w obu kierunkach, ale musi mieć wyraźny kierunek.
Operatory OR i NOT nie są obsługiwane we wzorcu MATCH.
FUNKCJA MATCH może być łączona z innymi wyrażeniami przy użyciu klauzuli AND w klauzuli WHERE. Jednak połączenie go z innymi wyrażeniami przy użyciu funkcji OR lub NOT nie jest obsługiwane.

Examples

Znajdź znajomego

Poniższy przykład tworzy tabelę węzłów Person i tabelę edge znajomych, wstawia niektóre dane, a następnie używa funkcji MATCH do znajdowania znajomych Alicji, osoby na grafie.

 -- Create person node table
 CREATE TABLE dbo.Person (ID INTEGER PRIMARY KEY, name VARCHAR(50)) AS NODE;
 CREATE TABLE dbo.friend (start_date DATE) AS EDGE;

 -- Insert into node table
 INSERT INTO dbo.Person VALUES (1, 'Alice');
 INSERT INTO dbo.Person VALUES (2,'John');
 INSERT INTO dbo.Person VALUES (3, 'Jacob');

-- Insert into edge table
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');

INSERT INTO dbo.friend VALUES ((SELECT $node_id FROM dbo.Person WHERE name = 'Alice'),
        (SELECT $node_id FROM dbo.Person WHERE name = 'Jacob'), '10/15/2011');

INSERT INTO dbo.friend VALUES ((SELECT $node_id FROM dbo.Person WHERE name = 'John'),
        (SELECT $node_id FROM dbo.Person WHERE name = 'Jacob'), '10/15/2012');

-- use MATCH in SELECT to find friends of Alice
SELECT Person2.name AS FriendName
FROM Person Person1, friend, Person Person2
WHERE MATCH(Person1-(friend)->Person2)
AND Person1.name = 'Alice';

Znajdź znajomego przyjaciela

Poniższy przykład próbuje znaleźć znajomego przyjaciela Alicji.

SELECT Person3.name AS FriendName
FROM Person Person1, friend, Person Person2, friend friend2, Person Person3
WHERE MATCH(Person1-(friend)->Person2-(friend2)->Person3)
AND Person1.name = 'Alice';

Znajdź osoby 1-3 przeskoki od danej osoby

Poniższy przykład znajduje najkrótszą ścieżkę między Jacobem a wszystkimi ludźmi, z którymi Jacob jest połączony w grafie jeden do trzech przeskoków od niego.

SELECT
    Person1.name AS PersonName,
    STRING_AGG(Person2.name, '->') WITHIN GROUP (GRAPH PATH) AS Friends
FROM
    Person AS Person1,
    friendOf FOR PATH AS fo,
    Person FOR PATH  AS Person2
WHERE MATCH(SHORTEST_PATH(Person1(-(fo)->Person2){1,3}))
AND Person1.name = 'Jacob'

Więcej wzorców

Poniżej przedstawiono kilka sposobów, w których można określić wzorzec wewnątrz FUNKCJI MATCH.

 -- Find a friend
    SELECT Person2.name AS FriendName
    FROM Person Person1, friend, Person Person2
    WHERE MATCH(Person1-(friend)->Person2);

-- The pattern can also be expressed as below

    SELECT Person2.name AS FriendName
    FROM Person Person1, friend, Person Person2
    WHERE MATCH(Person2<-(friend)-Person1);

-- Find 2 people who are both friends with same person
    SELECT Person1.name AS Friend1, Person2.name AS Friend2
    FROM Person Person1, friend friend1, Person Person2,
         friend friend2, Person Person0
    WHERE MATCH(Person1-(friend1)->Person0<-(friend2)-Person2);

-- this pattern can also be expressed as below

    SELECT Person1.name AS Friend1, Person2.name AS Friend2
    FROM Person Person1, friend friend1, Person Person2,
         friend friend2, Person Person0
    WHERE MATCH(Person1-(friend1)->Person0 AND Person2-(friend2)->Person0);

Treści powiązane

• CREATE TABLE (SQL Graph)
• INSERT (graf SQL)
• Przetwarzanie grafu za pomocą programu SQL Server i usługi Azure SQL Database
• SHORTEST_PATH (Transact-SQL)