Udostępnij przez


Kopiowanie danych z programu Jira przy użyciu usługi Azure Data Factory lub Synapse Analytics

DOTYCZY: Azure Data Factory Azure Synapse Analytics

Napiwek

Wypróbuj usługę Data Factory w usłudze Microsoft Fabric — rozwiązanie analityczne typu all-in-one dla przedsiębiorstw. Usługa Microsoft Fabric obejmuje wszystko, od przenoszenia danych do nauki o danych, analizy w czasie rzeczywistym, analizy biznesowej i raportowania. Dowiedz się, jak bezpłatnie rozpocząć nową wersję próbną !

W tym artykule opisano sposób używania działania kopiowania w potoku usługi Azure Data Factory lub Synapse Analytics do kopiowania danych z programu Jira. Jest on oparty na artykule omówienie działania kopiowania, który przedstawia ogólne omówienie działania kopiowania.

Ważne

Łącznik Jira w wersji 2.0 zapewnia ulepszoną natywną obsługę języka Jira. Jeśli używasz łącznika Jira w wersji 1.0 w rozwiązaniu, uaktualnij łącznik Jira przed 31 marca 2026 r. Zapoznaj się z tą sekcją , aby uzyskać szczegółowe informacje na temat różnic między wersją 2.0 a wersją 1.0.

Obsługiwane możliwości

Ten łącznik Jira jest obsługiwany w następujących funkcjach:

Obsługiwane możliwości środowisko IR
działanie Kopiuj (źródło/-) (1) (2)
Działanie Lookup (1) (2)

(1) Środowisko Azure Integration Runtime (2) Self-hosted Integration Runtime

Aby uzyskać listę magazynów danych obsługiwanych jako źródła/ujścia, zobacz tabelę Obsługiwane magazyny danych.

Usługa udostępnia wbudowany sterownik umożliwiający łączność, dlatego nie trzeba ręcznie instalować żadnego sterownika przy użyciu tego łącznika.

Wprowadzenie

Aby wykonać działanie kopiowania za pomocą pipeline'u, możesz użyć jednego z następujących narzędzi lub zestawów SDK:

Tworzenie połączonej usługi w programie Jira przy użyciu interfejsu użytkownika

Wykonaj poniższe kroki, aby utworzyć połączoną usługę jira w interfejsie użytkownika witryny Azure Portal.

  1. Przejdź do karty Zarządzanie w obszarze roboczym usługi Azure Data Factory lub Synapse i wybierz pozycję Połączone usługi, a następnie kliknij pozycję Nowy:

  2. Wyszukaj pozycję Jira i wybierz łącznik Jira.

    Wybierz łącznik Jira.

  3. Skonfiguruj szczegóły usługi, przetestuj połączenie i utwórz nową połączoną usługę.

    Skonfiguruj połączoną usługę w programie Jira.

Szczegóły konfiguracji łącznika

Poniższe sekcje zawierają szczegółowe informacje o właściwościach używanych do definiowania jednostek usługi Data Factory specyficznych dla łącznika Jira.

Właściwości połączonej usługi

Łącznik Jira obsługuje teraz wersję 2.0. Zapoznaj się z tą sekcją , aby uaktualnić wersję łącznika Jira z wersji 1.0. Aby uzyskać informacje szczegółowe dotyczące nieruchomości, zobacz odpowiednie sekcje.

Wersja 2.0

Połączona usługa Jira obsługuje następujące właściwości podczas stosowania wersji 2.0:

Właściwości Opis Wymagania
typ Właściwość type musi być ustawiona na: Jira Tak
wersja Wersja, którą określisz. Wartość to 2.0. Tak
gospodarz Adres IP lub nazwa hosta usługi Jira. Na przykład jira.example.com. Tak
port Port TCP używany przez serwer Jira do nasłuchiwania połączeń klienckich. Wartość domyślna to 443 w przypadku nawiązywania połączenia za pośrednictwem protokołu HTTPS lub 8080 w przypadku nawiązywania połączenia za pośrednictwem protokołu HTTP. Nie.
nazwa użytkownika Nazwa użytkownika używana do uzyskiwania dostępu do usługi Jira. Tak
hasło Token interfejsu API Atlassian (jeśli weryfikacja dwuetapowa jest włączona na koncie usługi Atlassian) lub hasło odpowiadające nazwie użytkownika podanej w polu nazwy użytkownika. Oznacz to pole jako element SecureString w celu bezpiecznego przechowywania go lub odwołuj się do wpisu tajnego przechowywanego w usłudze Azure Key Vault. Tak
connectVia Środowisko Integration Runtime będzie użyte do połączenia z repozytorium danych. Jeśli nie określono żadnej wartości, właściwość używa domyślnego środowiska Azure Integration Runtime. Możesz użyć własnego środowiska Integration Runtime, a jego wersja powinna mieć wartość 5.61 lub nowszą. Nie.

Przykład:

{
    "name": "JiraLinkedService",
    "properties": {
        "type": "Jira",
        "version": "2.0",
        "typeProperties": {
            "host" : "<host>",
            "port" : "<port>",
            "username" : "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

Wersja 1.0

Połączona usługa Jira obsługuje następujące właściwości podczas stosowania wersji 1.0:

Właściwości Opis Wymagania
typ Właściwość type musi być ustawiona na: Jira Tak
gospodarz Adres IP lub nazwa hosta usługi Jira. (na przykład jira.example.com) Tak
port Port TCP używany przez serwer Jira do nasłuchiwania połączeń klienckich. Wartość domyślna to 443 w przypadku nawiązywania połączenia za pośrednictwem protokołu HTTPS lub 8080 w przypadku nawiązywania połączenia za pośrednictwem protokołu HTTP. Nie.
nazwa użytkownika Nazwa użytkownika używana do uzyskiwania dostępu do usługi Jira. Tak
hasło Token interfejsu API Atlassian (jeśli weryfikacja dwuetapowa jest włączona na koncie usługi Atlassian) lub hasło odpowiadające nazwie użytkownika podanej w polu nazwy użytkownika. Oznacz to pole jako element SecureString w celu bezpiecznego przechowywania go lub odwołuj się do wpisu tajnego przechowywanego w usłudze Azure Key Vault. Tak
useEncryptedEndpoints Określa, czy punkty końcowe źródła danych są szyfrowane przy użyciu protokołu HTTPS. Wartość domyślna to true. Nie.
useHostVerification Określa, czy nazwa hosta w certyfikacie serwera ma być zgodna z nazwą hosta serwera podczas nawiązywania połączenia za pośrednictwem protokołu TLS. Wartość domyślna to true. Nie.
usePeerVerification Określa, czy należy zweryfikować tożsamość serwera podczas nawiązywania połączenia za pośrednictwem protokołu TLS. Wartość domyślna to true. Nie.

Przykład:

{
    "name": "JiraLinkedService",
    "properties": {
        "type": "Jira",
        "typeProperties": {
            "host" : "<host>",
            "port" : "<port>",
            "username" : "<username>",
            "password": {
                "type": "SecureString",
                "value": "<password>"
            }
        }
    }
}

Właściwości zestawu danych

Pełna lista sekcji i właściwości dostępnych do definiowania zestawów danych znajduje się w artykule dotyczącym zestawów danych. Ta sekcja zawiera listę właściwości obsługiwanych przez zestaw danych Jira.

Aby skopiować dane z programu Jira, ustaw właściwość type zestawu danych na JiraObject. Obsługiwane są następujące właściwości:

Właściwości Opis Wymagania
typ Właściwość type zestawu danych musi być ustawiona na: JiraObject Tak
schemat Nazwa schematu. Ta właściwość jest obsługiwana tylko w wersji 2.0. Tak
tabela Nazwa tabeli. Ta właściwość jest obsługiwana tylko w wersji 2.0. Tak
tableName Nazwa tabeli. Ta właściwość jest obsługiwana tylko w wersji 1.0. Nie (jeśli określono "zapytanie" w źródle działania)

Przykład

{
    "name": "JiraDataset",
    "properties": {
        "type": "JiraObject",
        "typeProperties": {},
        "schema": [],
        "linkedServiceName": {
            "referenceName": "<Jira linked service name>",
            "type": "LinkedServiceReference"
        }
    }
}

Łącznik w wersji 2.0 obsługuje następujące tabele Jira:

  • AdvancedSettings
  • WszystkieDostępneTypyProjektów
  • WszystkieRoleAplikacji
  • WszystkieDostępneWidżetyDashbordu
  • AllDashboards
  • AllFieldConfigurations
  • AllFieldConfigurationSchemes
  • WszystkieSchematyTypówZadań
  • AllLabels
  • Wszystkiepermisje
  • WszystkieSchematyPozwoleń
  • WszystkieKategorieProjektów
  • AllProjectRoles
  • AllProjectTypes
  • AllUserDataClassificationLevels (WszystkiePoziomyKlasyfikacjiDanychUżytkownika)
  • WszyscyUżytkownicy
  • DomyślneDlaWszystkichUżytkowników
  • WszystkieSchematyPrzepływówPracy
  • ApplicationProperty
  • Przybliżona liczba licencji
  • AttachmentMeta
  • Autouzupełnianie
  • DostępneImplementacjeŚledzeniaCzasu
  • Baner
  • BulkGetGroups
  • Konfiguracja
  • CurrentUser
  • Pulpity nawigacyjnePaginowane
  • Domyślny edytor
  • DefaultShareScope
  • Zdarzenia
  • Ulubione Filtry
  • FieldAutoCompleteForQueryString
  • MapowaniaSchematówKonfiguracjiPól
  • Pola
  • PolaPaginowane
  • FiltrowanieStronicowane
  • ZnajdźKomponentyDlaProjektów
  • ZnajdźGrupy
  • IdsOfWorklogsDeletedSince
  • IdsOfWorklogsModifiedSince
  • WszystkieRodzajeProblemów
  • Raport Ograniczenia Problemów
  • IssueLinkTypes
  • ZagadnienieNavigatorDefaultColumns
  • ProblemSelektorResource
  • ZagadnienieSecuritySchemes
  • MapowanieSchematówTypuProblemu
  • MapowaniaSchematówEkranówTypuProblemu
  • SchematyEkranuTypówProblemów
  • Licencja
  • Lokalizacja
  • Mojefiltry
  • Schematy powiadomień
  • MapowaniaSchematówPowiadomieńDoProjektów
  • Plany
  • SchematyPriorytetów
  • Niedawno
  • Ekrany
  • ScreenSchemes
  • Szukaj
  • ProjektyWyszukiwania
  • WyszukajProjektyPrzyUżyciuSchematówBezpieczeństwa
  • SearchResolutions
  • SearchSecuritySchemes
  • Przepływy pracy wyszukiwania
  • CzłonkowiePoziomuBezpieczeństwa
  • PoziomyBezpieczeństwa
  • WybranaImplementacjaŚledzeniaCzasu
  • ServerInfo
  • WspólnaKonfiguracjaŚledzeniaCzasu
  • StatusCategories
  • Statusy
  • UsuniętePolaStronicowane
  • KolumnyDomyślneUżytkownika

Właściwości działania kopiowania

Aby uzyskać pełną listę sekcji i właściwości dostępnych do definiowania działań, zobacz artykuł Pipelines (Potoki ). Ta sekcja zawiera listę właściwości obsługiwanych przez źródło jira.

Jira jako źródło

Aby skopiować dane z programu Jira, ustaw typ źródła w działaniu kopiowania na jiraSource. Następujące właściwości są obsługiwane w sekcji źródło działania kopiowania:

Właściwości Opis Wymagania
typ Właściwość type źródła działania kopiowania musi być ustawiona na: JiraSource Tak
kwerenda Użyj niestandardowego zapytania SQL, aby odczytać dane. Na przykład: "SELECT * FROM MyTable". Nie (jeśli określono "tableName" w zestawie danych)

Uwaga / Notatka

query nie jest obsługiwany w wersji 2.0.

Przykład:

"activities":[
    {
        "name": "CopyFromJira",
        "type": "Copy",
        "inputs": [
            {
                "referenceName": "<Jira input dataset name>",
                "type": "DatasetReference"
            }
        ],
        "outputs": [
            {
                "referenceName": "<output dataset name>",
                "type": "DatasetReference"
            }
        ],
        "typeProperties": {
            "source": {
                "type": "JiraSource",
                "query": "SELECT * FROM MyTable"
            },
            "sink": {
                "type": "<sink type>"
            }
        }
    }
]

Mapowanie typów danych dla usługi Jira

Podczas kopiowania danych z programu Jira następujące mapowania dotyczą typów danych programu Jira do wewnętrznych typów danych używanych przez usługę. Aby dowiedzieć się, jak działanie kopiowania mapuje schemat źródłowy i typ danych na docelowy, zobacz Mapowanie schematu i typu danych.

Typ danych Jira Typ danych usługi tymczasowej (wersja 2.0) Typ danych usługi tymczasowej (wersja 1.0)
ciąg Sznurek Varchar, Tekst
liczba całkowita Integer Int, Bigint
data/godzina Łańcuch, Data i Czas Data/godzina, sygnatura czasowa
typ logiczny (boolowski) logiczny Bit, Boolean
obiekt Object Spłaszczone, JSON
macierz Array Json, Oddzielna tabela

Właściwości działania wyszukiwania

Aby dowiedzieć się więcej o właściwościach, sprawdź działanie Wyszukiwania.

Cykl życia i uaktualnianie łącznika jira

W poniższej tabeli przedstawiono etap wydania i dzienniki zmian dla różnych wersji łącznika Jira:

wersja Etap wydania Dziennik zmian
Wersja 1.0 Ogłoszono zakończenie wsparcia /
Wersja 2.0 Wersja GA dostępna • Obsługa schema i table w zestawie danych.

• Obsługa określonych tabel Jira. Aby uzyskać listę obsługiwanych tabel, przejdź do pozycji Właściwości zestawu danych.

• Wersja własnego środowiska Integration Runtime powinna mieć wartość 5.61 lub nowszą.

• Mapowanie typu danych dla połączonej usługi Jira w wersji 2.0 różni się od tego dla wersji 1.0. Aby uzyskać najnowsze mapowanie typów danych, przejdź do pozycji Mapowanie typów danych dla programu Jira.

useEncryptedEndpoints, useHostVerification, usePeerVerification nie są obsługiwane w połączonej usłudze.

query nie jest obsługiwana.

• Uwierzytelnianie OAuth 1.0 nie jest obsługiwane.

Uaktualnianie łącznika Jira z wersji 1.0 do wersji 2.0

  1. Na stronie Edytowanie połączonej usługi wybierz wersję 2.0 i skonfiguruj połączoną usługę, odwołując się do właściwości połączonej usługi w wersji 2.0.

  2. Mapowanie typu danych dla połączonej usługi Jira w wersji 2.0 różni się od tego dla wersji 1.0. Aby dowiedzieć się więcej na temat najnowszego mapowania typów danych, zobacz Mapowanie typów danych dla programu Jira.

  3. Jeśli używasz własnego środowiska Integration Runtime, jego wersja powinna mieć wartość 5.61 lub nowszą.

  4. query program jest obsługiwany tylko w wersji 1.0. Należy użyć elementu schema i table zamiast query w wersji 2.0.

Uwaga / Notatka

Wersja 2.0 obsługuje określone tabele Jira. Aby uzyskać listę obsługiwanych tabel, przejdź do pozycji Właściwości zestawu danych.

Aby uzyskać listę magazynów danych obsługiwanych jako źródła i ujścia działania kopiowania, zobacz obsługiwane magazyny danych.