Rozszerzalność usługi Azure Data Studio

Usługa Azure Data Studio ma kilka mechanizmów rozszerzalności, które umożliwiają dostosowanie środowiska użytkownika i udostępnienie tych dostosowań całej społeczności użytkowników. Podstawowa platforma Azure Data Studio jest oparta na programie Visual Studio Code, więc większość interfejsów API rozszerzalności programu Visual Studio Code jest dostępna. Ponadto udostępniliśmy inne punkty rozszerzalności dla działań specyficznych dla zarządzania danymi.

Niektóre z kluczowych punktów rozszerzalności to:

• Interfejsy API rozszerzalności programu Visual Studio Code
• Narzędzia do tworzenia rozszerzeń usługi Azure Data Studio
• Zarządzanie udziałami w panelu kart pulpitu nawigacyjnego
• Wgląd z interaktywnym doświadczeniem
• Interfejsy API rozszerzalności narzędzia Azure Data Studio
• Niestandardowe interfejsy API Dostawca danych

Interfejsy API rozszerzalności programu Visual Studio Code

Ponieważ podstawowa platforma Azure Data Studio jest oparta na programie Visual Studio Code, szczegółowe informacje o interfejsach API rozszerzalności programu Visual Studio Code znajdują się w dokumentacji interfejsu API tworzenia rozszerzeń i rozszerzenia w witrynie internetowej programu Visual Studio Code.

Zarządzanie udziałami w panelu kart pulpitu nawigacyjnego

Aby uzyskać szczegółowe informacje, zobacz Punkty współtworzenia i Zmienne kontekstowe.

Interfejsy API rozszerzalności narzędzia Azure Data Studio

Aby uzyskać szczegółowe informacje, zobacz Interfejsy API rozszerzalności.

Punkty udziału

Ta sekcja obejmuje różne punkty wkładu zdefiniowane w manifeście rozszerzenia package.json.

Funkcja IntelliSense jest obsługiwana w programie azuredatastudio.

Punkty współtworzenia pulpitu nawigacyjnego

Współtworzenie karty, kontenera i/lub widżetu szczegółowych informacji na pulpicie nawigacyjnym.

zakładki pulpitu

Pulpit nawigacyjny.tabs tworzy sekcje tabulacji na stronie pulpitu nawigacyjnego. Oczekuje obiektu lub tablicy obiektów.

"dashboard.tabs": [
    {
        "id": "test-tab1",
        "title": "Test 1",
        "description": "The test 1 displays a list of widgets.",
        "when": "connectionProvider == 'MSSQL' && !mssql:iscloud",
        "alwaysShow": true,
        "container": {
            ...
        }
    }
]

pulpit.kontenery

Zamiast określać kontener pulpitu nawigacyjnego w treści (na karcie pulpitu nawigacyjnego), możesz zarejestrować kontenery przy użyciu dashboard.containers. Akceptuje obiekt lub tablicę obiektów.

"dashboard.containers": [
    {
        "id": "innerTab1",
        "widgets-container": [
            {
                "widget": {
                    "query-data-store-db-insight": {}
                }
            },
            {
                "widget": {
                    "explorer-widget": {}
                }
            }
        ]
    },
    {
        "id": "innerTab2",
        "webview-container": {}
    },
    {
        "id": "innerTab3",
        "grid-container": [
            {
                "name": "widget 1",
                "widget": {
                    "explorer-widget": {}
                },
                "row": 0,
                "col": 0
            },
            {
                "name": "widget 2",
                "widget": {
                    "tasks-widget": {
                        "backup",
                        "restore",
                        "configureDashboard",
                        "newQuery"
                    }
                },
                "row": 0,
                "col": 1
            },
            {
                "name": "Webview 1",
                "webview": {
                    "id": "google"
                },
                "row": 1,
                "col": 0,
                "colspan": 2
            },
            {
                "name": "widget 3",
                "widget": {
                    "explorer-widget": {}
                },

Aby odwołać się do zarejestrowanego kontenera, określ identyfikator kontenera.

"dashboard.tabs": [
    {
        "id": "test-tab1",
        "title": "Test 1",
        "description": "The test 1 displays a list of widgets.",
        "when": "connectionProvider == 'MSSQL' && !mssql:iscloud",
        "alwaysShow": true,
        "container": {
            "id": "innerTab1"
        }
    }
]

panel.wgląd

Szczegółowe informacje można zarejestrować przy użyciu pulpitu nawigacyjnego.insights. Jest to podobne do samouczek: tworzenie niestandardowego widżetu do analizy danych. Akceptuje obiekt lub tablicę obiektów.

"dashboard.insights": {
    "id": "my-widget",
    "type": {
        "count": {
            "dataDirection": "vertical",
            "dataType": "number",
            "legendPosition": "none",
            "labelFirstColumn": false,
            "columnsAsLabels": false
        }
    },
    "queryFile": "{your file folder}/activeSession.sql"
}

Typy kontenerów pulpitu nawigacyjnego

Obecnie istnieją cztery obsługiwane typy kontenerów:

kontener widżetów

Lista widżetów, które będą wyświetlane w kontenerze, to układ przepływu, który akceptuje tę listę.

"container": {
    "widgets-container": [
        {
            "widget": {
                "query-data-store-db-insight": {}
            }
        },
        {
            "widget": {
                "explorer-widget": {}
            }
        }
    ]
}

webview-container

Widok internetowy jest wyświetlany w całym kontenerze. Oczekuje się, że identyfikator widoku internetowego będzie taki sam jak identyfikator karty.

"container": {
    "webview-container": {}
}

grid-container

Lista widżetów lub widoków internetowych wyświetlanych w układzie siatki. Układ siatki to układ siatki 2x2, który akceptuje tę listę.

"container": {
    "grid-container": [
        {
            "name": "widget 1",
            "widget": {
                "explorer-widget": {}
            },
            "row": 0,
            "col": 0
        },
        {
            "name": "widget 2",
            "widget": {
                "tasks-widget": {
                    "backup",
                    "restore",
                    "configureDashboard",
                    "newQuery"
                }
            },
            "row": 0,
            "col": 1
        },
        {
            "name": "Webview 1",
            "webview": {
                "id": "google"
            },
            "row": 1,
            "col": 0,
            "colspan": 2
        },
        {
            "name": "widget 3",
            "widget": {
                "explorer-widget": {}
            },
            "row": 0,
            "col": 3,
            "rowspan": 2
        }
    ]
}

sekcja nawigacji

Sekcja nawigacji jest wyświetlana w kontenerze. Oczekuje tablicy obiektów.

"container": {
    "nav-section": [
        {
            "id": "innerTab1",
            "title": "inner-tab1",
            "icon": {
                "light": "./icons/tab1Icon.svg",
                "dark": "./icons/tab1Icon_dark.svg"
            },
            "container": {
                ...
            }
        },
        {
            "id": "innerTab2",
            "title": "inner-tab2",
            "icon": {
                "light": "./icons/tab2Icon.svg",
                "dark": "./icons/tab2Icon_dark.svg"
            },
            "container": {
                ...
            }
        }
    ]
}

Zmienne kontekstu

Aby uzyskać ogólne informacje na temat kontekstu w programie Visual Studio Code i nowszym narzędziu Azure Data Studio, zobacz rozszerzalność.

W narzędziu Azure Data Studio mamy określony kontekst dotyczący połączeń bazy danych dostępnych dla rozszerzeń.

Pulpit nawigacyjny

Na pulpicie nawigacyjnym udostępniamy następujące zmienne kontekstowe:

Powiązana zawartość

• API interfejsy rozszerzalności
• Pobierz Azure Data Studio