Azure SQL -tietokannan CDC-lähteen lisääminen tapahtumavirtaan

Tässä artikkelissa kerrotaan, miten voit lisätä Azure SQL -tietokannan muutostietokaappauksen (CDC) lähteen tapahtumavirtaan.

Microsoft Fabric -tapahtumavirtojen Azure SQL -tietokannan CDC-lähdeliittimen avulla voit siepata tilannevedoksen nykyisistä tiedoista Azure SQL -tietokannassa. Liitin valvoo ja kirjaa mahdolliset tulevat rivitason muutokset näihin tietoihin. Kun muutokset on saatu tapahtumavirtaan, voit käsitellä nämä CDC-tiedot reaaliaikaisesti ja lähettää ne Fabricissa eri kohteisiin jatkokäsittelyä tai analyysia varten.

Edellytykset

Työtilan käyttöoikeus Fabric-kapasiteetin käyttöoikeustilassa (tai) kokeiluversion käyttöoikeustilassa Osallistuja-oikeudella tai korkeammilla käyttöoikeuksilla.
Käynnissä oleva Azure SQL -palvelin, jossa on Azure SQL -tietokanta.
Azure SQL -tietokantasi on oltava julkisesti käytettävissä, eikä se saa olla palomuurin takana tai suojattu näennäisverkossa.
Ottanut CDC:n käyttöön Azure SQL -tietokannassa suorittamalla tallennetun toimintosarjan sys.sp_cdc_enable_db. Lisätietoja on kohdassa Ota tietokaappaus käyttöön ja poista se käytöstä.
Jos sinulla ei ole tapahtumastreamia, luo tapahtumavirta.

Huomaa, että peilausta ei saa ottaa käyttöön Azure SQL -tietokannassa.

CDC:n ottaminen käyttöön Azure SQL -tietokannassa

Siirry Azure-portaali, avaa Azure SQL -tietokanta ja valitse Kyselyeditori. Valitse kirjautumismenetelmä.

Ota CDC käyttöön tietokannassa suorittamalla seuraavat SQL-komennot:

-- Enable Database for CDC
EXEC sys.sp_cdc_enable_db;

-- Enable CDC for a table using a gating role option
EXEC sys.sp_cdc_enable_table
    @source_schema = N'dbo',
    @source_name   = N'MyTable',
    @role_name     = NULL
GO

Käynnistä ohjattu Tietolähteen valitseminen -toiminto

Jos et ole vielä lisännyt lähdettä eventstreamiin, valitse Käytä ulkoista lähdettä -ruutu.

Jos lisäät lähdekoodin jo julkaistuun tapahtumavirtaan, vaihda muokkaustilaan . Nauhalta valitse Lisää lähde>Ulkoiset lähteet.

Etsi Ja valitse Valitse tietolähde -sivulta YhdistäAzure SQL DB (CDC) -ruudussa.

Azure SQL -tietokannan CDC:n määrittäminen ja siihen yhdistäminen

Valitse Yhdistä-sivullaUusi yhteys.
Anna Yhteysasetukset-osiossa Seuraavat arvot Azure SQL -tietokannalle:
- Palvelin: Anna Azure SQL -palvelimen nimi Azure-portaali. Se on tässä muodossa: mysqlservername.database.windows.net.
- Tietokanta: Anna Azure SQL -tietokannan nimi Azure-portaali.
Vieritä alaspäin ja toimi Yhteyden tunnistetiedot -osiossa seuraavien ohjeiden mukaisesti.
- Anna yhteyden nimi Yhteyden nimi -kohtaan.
- Valitse todennuslajiksi Perus.
  
  Muistiinpano
  
  Tällä hetkellä Fabric Eventstream tukee vain perustodennusta .
- Anna tietokannan käyttäjänimi ja salasana .
Valitse Yhdistä.
Valitse nyt Yhdistä-sivullaKaikki taulukot tai Anna taulukon nimet. Jos valitset jälkimmäisen, määritä taulukot käyttämällä pilkuin eroteltua luetteloa kokonaisista taulukon tunnisteista (schemaName.tableName) tai kelvollisia säännönmukaisia lausekkeita. Esimerkki:
- dbo.test.* avulla voit valita kaikki taulukot, joiden nimi alkaa dbo.test.
- valitse dbo\.(test1|test2) ja dbo.test1dbo.test2 avulla.
Voit yhdistellä molempia muotoiluja pilkuilla. Koko merkinnän merkkirajoitus on 102 400 merkkiä.
Voit avata Lisäasetukset päästäksesi Azure SQL Database CDC:n lähteen lisäkonfiguraatioasetuksiin:
- Desimaalikäsittelytila: Määrittelee, miten liitin käsittelee DECIMAL sarakkeiden arvoja NUMERIC :
  - Precise: Edustaa arvoja käyttäen tarkkoja desimaalityyppejä (esimerkiksi Java BigDecimal), joilla varmistetaan tietojen esityksen täysi tarkkuus ja tarkkuus.
  - Double: muuntaa arvot kaksoistarkoiksi liukupisteluvuiksi. Tämä asetus parantaa käytettävyyttä ja suorituskykyä, mutta saattaa heikentää tarkkuutta.
  - String: Koodaa arvot muotoiltuina merkkijonoina. Tämä asetus helpottaa käyttöä tuotantoketjun loppupään järjestelmissä, mutta menettää semanttisia tietoja alkuperäisestä numeerisesta tyypistä.
- Snapshot-tila: Määritä kriteerit snapshotin suorittamiselle, kun liitin käynnistyy:
  - Initial: Liitin suorittaa snapshotin vain, kun loogisen palvelimen nimen offsetteja ei ole kirjattu tai jos se havaitsee, että aiempi snapshotti epäonnistui valmistumaan. Snapshotin valmistuttua liitin alkaa striimata tapahtumatietueita myöhempiä tietokantamuutoksia varten.
  - InitialOnly: Liitin suorittaa snapshotin vain, kun loogiselle palvelimen nimelle ei ole tallennettu offsetteja. Snapshotin valmistuttua liitin pysähtyy. Se ei siirry suoratoistoon lukeakseen muutoksia binlogista.
  - NoData: Liitin suorittaa snapshotin, joka tallentaa vain skeeman, mutta ei taulukkodataa. Aseta tämä asetus, jos et tarvitse johdonmukaista tilannekuvaa datasta, vaan tarvitset vain ne muutokset, jotka tapahtuvat liittimen käynnistymisestä lähtien.
- Sarakkeen poissulkemislista: Määrittää sarakkeet, jotka poistetaan muutostapahtumaarvoista täysin määritellyillä nimillä (schemaName.tableName.columnName).
- TietokantasovellusIntent: Määrittää reitityskäyttäytymisen SQL Server Always On -saatavuusryhmissä:
  - ReadWrite: Yhdistyy pääreplikaan. Käytä tätä, jos yhteyden täytyy suorittaa sekä luku- että kirjoitustoimintoja.
  - ReadOnly: Mahdollistaa reitityksen luettavaan toissijaiseen replikaan vain luku -toimintoja varten. Käytä sitä CDC:n aktivoimiseen suoraan replikoille. Se vaatii snapshot.isolation.moden asettamisen snapshotiksi, joka on ainoa transaktioiden eristystila, jota tuetaan vain luku -replikoille.
- Snapshotin valintalauseen ohitus: Käytä ominaisuutta, jos haluat snapshotin sisältävän vain osan taulukon riveistä. Tämä ominaisuus vaikuttaa vain snapshot-otoksiin. Se ei koske tapahtumia, joita liitin lukee lokista.
Valitse Seuraava.
Tarkista yhteenveto Ja luo -näytössä ja valitse sitten Lisää.

Käsittele muutostietoja Azure SQL -tietokannoista automaattisella taulukkorakenteen rekisteröinnillä CDC:n kautta Eventstreamiin.

Valitse Yhdistä-sivullaUusi yhteys.
Anna Yhteysasetukset-osiossa Seuraavat arvot Azure SQL -tietokannalle:
- Palvelin: Anna Azure SQL -palvelimen nimi Azure-portaali. Se on tässä muodossa: mysqlservername.database.windows.net.
- Tietokanta: Anna Azure SQL -tietokannan nimi Azure-portaali.
Vieritä alaspäin ja toimi Yhteyden tunnistetiedot -osiossa seuraavien ohjeiden mukaisesti.
- Anna yhteyden nimi Yhteyden nimi -kohtaan.
- Valitse todennuslajiksi Perus.
  
  Muistiinpano
  
  Tällä hetkellä Fabric Eventstream tukee vain perustodennusta .
- Anna tietokannan käyttäjänimi ja salasana .
Valitse Yhdistä.
Valitse nyt Yhdistä-sivullaKaikki taulukot tai Anna taulukon nimet. Jos valitset jälkimmäisen, määritä taulukot käyttämällä pilkuin eroteltua luetteloa kokonaisista taulukon tunnisteista (schemaName.tableName) tai kelvollisia säännönmukaisia lausekkeita. Esimerkki:
- dbo.test.* avulla voit valita kaikki taulukot, joiden nimi alkaa dbo.test.
- valitse dbo\.(test1|test2) ja dbo.test1dbo.test2 avulla.
Voit yhdistellä molempia muotoiluja pilkuilla. Koko merkinnän merkkirajoitus on 102 400 merkkiä.
Voit avata Lisäasetukset päästäksesi Azure SQL Database CDC:n lähteen lisäkonfiguraatioasetuksiin:
- Desimaalikäsittelytila: Määrittelee, miten liitin käsittelee DECIMAL sarakkeiden arvoja NUMERIC :
  - Precise: Edustaa arvoja käyttäen tarkkoja desimaalityyppejä (esimerkiksi Java BigDecimal), joilla varmistetaan tietojen esityksen täysi tarkkuus ja tarkkuus.
  - Double: muuntaa arvot kaksoistarkoiksi liukupisteluvuiksi. Tämä asetus parantaa käytettävyyttä ja suorituskykyä, mutta saattaa heikentää tarkkuutta.
  - String: Koodaa arvot muotoiltuina merkkijonoina. Tämä asetus helpottaa käyttöä tuotantoketjun loppupään järjestelmissä, mutta menettää semanttisia tietoja alkuperäisestä numeerisesta tyypistä.
- Snapshot-tila: Määritä kriteerit snapshotin suorittamiselle, kun liitin käynnistyy:
  - Initial: Liitin suorittaa snapshotin vain, kun loogisen palvelimen nimen offsetteja ei ole kirjattu tai jos se havaitsee, että aiempi snapshotti epäonnistui valmistumaan. Snapshotin valmistuttua liitin alkaa striimata tapahtumatietueita myöhempiä tietokantamuutoksia varten.
  - InitialOnly: Liitin suorittaa snapshotin vain, kun loogiselle palvelimen nimelle ei ole tallennettu offsetteja. Snapshotin valmistuttua liitin pysähtyy. Se ei siirry suoratoistoon lukeakseen muutoksia binlogista.
  - NoData: Liitin suorittaa snapshotin, joka tallentaa vain skeeman, mutta ei taulukkodataa. Aseta tämä asetus, jos et tarvitse johdonmukaista tilannekuvaa datasta, vaan tarvitset vain ne muutokset, jotka tapahtuvat liittimen käynnistymisestä lähtien.
- Sarakkeen poissulkemislista: Määrittää sarakkeet, jotka poistetaan muutostapahtumaarvoista täysin määritellyillä nimillä (schemaName.tableName.columnName).
- TietokantasovellusIntent: Määrittää reitityskäyttäytymisen SQL Server Always On -saatavuusryhmissä:
  - ReadWrite: Yhdistyy pääreplikaan. Käytä tätä, jos yhteyden täytyy suorittaa sekä luku- että kirjoitustoimintoja.
  - ReadOnly: Mahdollistaa reitityksen luettavaan toissijaiseen replikaan vain luku -toimintoja varten. Käytä sitä CDC:n aktivoimiseen suoraan replikoille. Se vaatii snapshot.isolation.moden asettamisen snapshotiksi, joka on ainoa transaktioiden eristystila, jota tuetaan vain luku -replikoille.
- Snapshotin valintalauseen ohitus: Käytä ominaisuutta, jos haluat snapshotin sisältävän vain osan taulukon riveistä. Tämä ominaisuus vaikuttaa vain snapshot-otoksiin. Se ei koske tapahtumia, joita liitin lukee lokista.
Ota tapahtumarakenteen yhdistäminen käyttöön.
Valitse Työtila-kohdassa rakennejoukon Kangas-työtila.
Rakennejoukossa on oletusarvoisesti valittuna + Luo, mikä luo uuden rakennejoukon. Voit muuttaa sitä valitaksesi aiemmin luodun tapahtumarakennejoukon.
Jos valitsit + Luo -vaihtoehdon edellisessä vaiheessa, kirjoita rakennejoukon nimi.
Valitse Tarkista ja yhdistä -sivulla lisää .

Kaikille Azure SQL -tietokannan taulukoille tai valituille taulukoille liitin etsii ja luo rakenteet automaattisesti ja rekisteröi ne rakennerekisteriin.
Valitse keskellä oleva tapahtumavirtasolmu ja siirry alaruudun Liittyvät rakenteet -välilehteen.

Kaavion joukko

Siirry edellisessä vaiheessa valitsemaasi työtilaan. Seuraavassa esimerkissä se on Oma työtila.
Valitse rakennejoukko, jonka Azure SQL Database (CDC) -liitin loi.
Näet rakennejoukon rakenteet seuraavassa kuvassa esitetyllä tavalla.
Jos haluat nähdä rakenteen JSON-version, siirry JSON-rakennenäkymään .

Älä muuta näitä löydettyjä rakenteita tämän editorin avulla, koska se ei vahvista Azure SQL -tietokantalähteen taulukoiden rakennetta.

Näytä päivitetty tapahtumavirta

Näet, että Azure SQL -tietokannan (CDC) lähde lisätään tapahtumavirtaasi Muokkaa-tilassa.
Jos haluat ottaa käyttöön tämän äskettäin lisätyn Azure SQL -tietokannan CDC-lähteen, valitse Julkaise. Kun olet suorittanut nämä vaiheet, Azure SQL -tietokannan CDC-lähde on visualisoitavissa reaaliaikaisessa näkymässä.

Tapahtumavirran kohteiden määrittäminen käyttämään rakenteita

Tällä hetkellä vain eventhouse, mukautettu päätepiste ja johdetut virtakohteet ovat tuettuja tapahtumavirroille, joissa laajennetut ominaisuudet ovat käytössä. Tässä osiossa näytetään, miten eventhouse-kohde lisätään ja konfiguroidaan, kun laajennetut ominaisuudet (kuten skeematuki) ovat käytössä eventstreamille.

Määritä skeema mukautetulle päätepisteelle

Valitse Muunna tapahtumat tai lisää kohde, ja valitse sitten CustomEndpoint.
Mukautettu päätepiste -paneelissa määritä kohde nimeksi.
Valitse Syöterakenne-kohdassa tapahtumien rakenne. Teet valinnan tässä laatikossa, kun otat skeematuen käyttöön tapahtumavirralle.

Yksityiskohtaiset ohjeet mukautetun päätepisteen kohteen määrittämiseen ovat artikkelissa Mukautetun päätepisteen tai mukautetun sovelluksen kohteen lisääminen tapahtumavirtaan.

Tapahtumatalon kohteen rakenteiden määrittäminen

Valitse Muunna tapahtumat tai Lisää kohde ja valitse sitten Eventhouse.
Eventhouse-paneelissa määritä seuraavat skeema-asetukset:
1. Syöteskeemalle valitse yksi tai useampi skeema pudotusvalikosta.
  
  Muistiinpano
  
  Jos valitsit Dynamic skeeman otsikoiden kautta -vaihtoehdon konfiguroidessasi Event Hubsin lähdekoodia, saatat olla konfiguroinut useita skeemoja lähteelle ja kartoittanut ne eri ominaisuuksiin ja arvoihin.
2. Taulun luontitapaa varten valitse Yksi taulu, jossa kaikki skeemat on yhdistetty, tai Erilliset taulukot jokaiselle skeemalle tarpeidesi mukaan.
3. Valitse Kirjoita tiedot -kohdassa jokin seuraavista vaihtoehdoista:
  - Vain hyötykuorma: Kirjoita purettu hyötykuorma taulukkoon. Jos syöterakenteita on useita, tiedot lähetetään useisiin taulukoihin.
  - Metatiedot ja hyötykuorma: Kirjoita metatiedot ja tietosisältötiedot yhteen taulukkoon. Esimerkkisarakkeita ovat source , subject, type, ja data.

Yksityiskohtaiset vaiheet tapahtumatalon kohteen konfigurointiin löydät kohdasta Lisää tapahtumatalon kohde tapahtumavirtaan.

Muut liittimet:

Palaute

Onko tästä sivusta apua?

Last updated on 2025-11-26