Nuta
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować się zalogować lub zmienić katalog.
Dostęp do tej strony wymaga autoryzacji. Możesz spróbować zmienić katalogi.
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:
- Narzędzie do kopiowania danych
- Portal Azure
- zestawu SDK platformy .NET
- Zestaw SDK dla języka Python
- Azure PowerShell
- API REST
- Szablon usługi Azure Resource Manager
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.
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:
Wyszukaj pozycję Jira i wybierz łącznik Jira.
Skonfiguruj szczegóły usługi, przetestuj połączenie i utwórz nową połączoną usługę.
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
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.
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.
Jeśli używasz własnego środowiska Integration Runtime, jego wersja powinna mieć wartość 5.61 lub nowszą.
queryprogram jest obsługiwany tylko w wersji 1.0. Należy użyć elementuschemaitablezamiastqueryw 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.
Powiązana zawartość
Aby uzyskać listę magazynów danych obsługiwanych jako źródła i ujścia działania kopiowania, zobacz obsługiwane magazyny danych.