Peilattujen Fabric-tietokantojen vianmääritys joustavasta Azure Database for PostgreSQL -palvelimesta

Tässä artikkelissa käsitellään joustavan Azure Database for PostgreSQL -palvelimen peilaamisen vianmääritysvaiheita.

Virhe-/varoitusviestien vianmääritys peilauksen taulukon valinnan aikana

Kun luot uuden peilatun tietokannan, saatat saada Valitse tiedot -sivulla visuaalista palautetta lähdetietokannan tietyistä taulukoista. Seuraavassa taulukossa on luettelo mahdollisista ongelmista, mukaan lukien näyttöön tuleva sanoma ja siihen liittyvä kuvaus ongelman ratkaisemisesta.

¹ Välilyönnin (' ') merkkiä sisältäviä objektitunnisteita ei tueta.

² Tätä taulukkotyyppiä ei tueta peilauksessa. Tällä hetkellä näkymiä, materialisoituja näkymiä, vieraita taulukoita ja osioituja taulukoita ei tueta. TimescaleDB-hypertaulukoita ei myöskään tueta Fabric Mirroringissa.

³ Luettelo tietotyypeistä, joita ei tueta, on kohdassa Rajoitukset. Vain sarakkeita, joilla on seuraavat tyypit, tuetaan:

• bigint
• bigserial
• boolean
• bytea
• character
• character varying
• date
• double precision
• integer
• numeric
• real
• serial
• oid
• money
• smallint
• smallserial
• text
• time without time zone
• time with time zone (* ei perusavaimena)
• timestamp without time zone
• timestamp with time zone
• uuid
• xml
• json
• jsonb
• inet
• cidr
• macaddr
• macaddr8
• tsvector
• tsquery
• int4range
• int8range
• numrange
• tsrange
• tstzrange
• daterange
• circle
• line
• lseg
• box
• path
• point
• polygon
• interval

Postgresissa kahta "aika aikavyöhykkeellä" -arvoa, jotka vastaavat täsmälleen samaa hetkeä, mutta eri aikavyöhykkeillä, pidetään erilaisina. Esimerkiksi: 06:24:00.59+05 ja 05:24:00.59+04 vastaavat samaa aikakauden aikaa, mutta Postgres kohtelee niitä eri tavalla.

Oletusrajoittamattomat numeeriset sarakkeet lähdetietokantaskeemoissa (ilman määriteltyä tarkkuutta ja skaalausta) muunnetaan muotoon Decimal128(38, 0) ennen kuin ne replikoidaan OneLake-tauluihin, mikä vastaa SQL-standardikäytäntöä, jonka mukaan määrittelemätön skaalaus tarkoittaa kokonaislukutarkkuutta.

Lähdetietokannassa tuetut tietojen määrittelykielen (DDL) toiminnot

• Rename-sarakke: sarake uudella nimellä lisätään peilikuvaan taulukkoon Fabric ja sisältää tiedot uusista riveistä (olemassa olevat rivit ovat NULL). Vanha sarake säilytetään edelleen olemassa olevien rivien arvoilla (uudet rivit ovat NOLLA).
• Lisää sarakke: lisätty sarake näkyy peilatussa taulukossa ja sisältää tiedot uusista riveistä (nykyiset rivit ovat NULL).
• Poista sarakke: poistettu sarake pysyy näkyvissä peilitaulukossa ja sisältää tiedot olemassa olevista riveistä (uudet rivit ovat NULL).
• Vaihda pääavain: peilaussessio jatkuu säännöllisesti.

Mikään muu DDL-operaatio lähdetauluilla ei tällä hetkellä ole tuettuja ja voi aiheuttaa replikaatiovirheitä.

Fabric-kapasiteetin tai työtilan muutokset

SQL-kyselyt vianmääritystä varten

Jos kohtaat peilausongelmia, yhdistä lähdekoodi Azure Database for PostgreSQL -palvelimeen ja tee nämä tarkistukset järjestelmänäkymien ja -toimintojen avulla konfiguraation validointiin.

1. Suorita seuraava kysely varmistaaksesi, täyttyvätkö kaikki edellytykset ennen CDC-peilauksen aloittamista. Tämä toiminto tarkistaa erilaiset järjestelmä- ja konfiguraatiovaatimukset varmistaakseen, että palvelin on valmis CDC:n toimintaan.

-- Check if all prerequisites are met
SELECT * FROM azure_cdc.check_prerequisites();

-- Example output when all checks pass (on mock mode with identity configured):
 status |                                                               data
--------+----------------------------------------------------------------------------------------------------------------------------------
 ERROR  | [{"status": "ERROR", "details": {"current_value": "12", "required_value": "13"}, "status_code": "MAX_WORKER_PROCESSES_TOO_LOW"}]

-- Example output on standby replica:
 status |                                               data
--------+---------------------------------------------------------------------------------------------------
 ERROR  | [{"status": "ERROR", "status_code": "SERVER_IN_RECOVERY"}]

-- Example output when identity not configured:
 status |                                data
--------+---------------------------------------------------------------------
 ERROR  | [{"status": "ERROR", "status_code": "IDENTITY_NOT_CONFIGURED"}]

Palautukset:(status text, data jsonb)

• status: Yleinen tila – OK jos kaikki tarkistukset läpäisevät, ERROR jos jokin tarkistus epäonnistuu
• data: JSONB-taulukko, joka sisältää yksityiskohtaiset tilamerkinnät, joissa status, status_code, ja valinnainen details

Tilakoodit:

2. Suorita seuraava kysely varmistaaksesi, ovatko lähdetietokantasi taulut kelpoisia replikaatioon. Sulkee pois järjestelmäskeemat (pg_catalog, information_schema, pg_toast) ja laajennuksen omistamat taulukot.

SELECT * FROM azure_cdc.get_all_tables_mirror_status();
 table_schema | table_name | mirroring_status |                      mirroring_data
--------------+------------+------------------+------------------------------------------------------
 public       | customers  | OK               | [{"status": "OK", "status_code": "HAS_PRIMARY_KEY"}]
 public       | orders     | OK               | [{"status": "OK", "status_code": "HAS_UNIQUE_INDEX"}]
 public       | logs       | WARNING          | [{"status": "WARNING", "status_code": "NO_INDEX_FULL_IDENTITY"}]

Palautukset: Joukko (table_schema text, table_name text, mirroring_status text, mirroring_data jsonb)

• table_schema: Taulukon skeeman nimi
• table_name: Taulukon nimi
• mirroring_status: Kokonaistila - OK, WARNING, tai ERROR
• mirroring_data: JSONB-taulukko, joka sisältää yksityiskohtaiset tilamerkinnät, joissa status, status_code, ja valinnainen details

Tilakoodit:

3. Suorita seuraava kysely palauttaaksesi replikaatiotoimintojen aikana havaitut virheet ja ongelmat, mukaan lukien järjestelmätason virheet, julkaisukohtaiset virheet ja taulukkokohtaiset virheet.

-- Get only system-wide errors
SELECT * FROM azure_cdc.get_health_status('', '');

-- Get system-wide errors and publication-specific errors
SELECT * FROM azure_cdc.get_health_status('my_database', 'my_publication');

Parametrit:

• db_name (teksti): Tietokannan nimi
• pub_name (teksti): Julkaisun nimi

Käyttäytyminen:

• Kun kutsutaan tyhjillä merkkijonoilla molemmille parametreille (azure_cdc.get_health_status('', '')): Palauttaa vain järjestelmätason virheitä (virhetyyppi 'S').
• Kun kutsutaan kelvollisilla tietokanta- ja julkaisunimillä: Palauttaa sekä järjestelmätason virheet että julkaisu- ja taulukkokohtaiset virheet määritellystä julkaisusta.

Palautukset: Joukko (error_time timestamptz, schema_name text, table_name text, error_type char(1), error_code text, params jsonb)

Virhetyypit:

Virhekoodit:

4. Suorita seuraava kysely tarkistaaksesi, onko julkaisu luotu oikein ja replikaatiomuutokset sujuvat oikein:

   select * from azure_cdc.tracked_publications;
   

   Tarkista, onko julkaisu aktiivinen ja tilannekuva on luotu. Voit myös tarkistaa, onko myöhempiä muutoseriä luotu kyselemällä:

   select * from azure_cdc.tracked_batches;
   

5. Jos azure_cdc.tracked_publications näkymä ei näytä edistymistä inkrementaalisten muutosten käsittelyssä, suorita seuraava SQL-kysely ja tarkista, onko raportoitu ongelmia:

   SELECT * FROM pg_stat_activity WHERE state = 'idle in transaction';
   

6. Jos ongelmia ei ole raportoitu, suorita seuraava komento tarkistaaksesi peilatun PostgreSQL-tietokannan nykyiset määritykset. Varmista, että se on otettu käyttöön oikein.

   SELECT * FROM pg_replication_slots;
   

   Tässä etsittävät avainsarakkeet ovat ja slot_nameactive. Mikä tahansa arvo ( t tosi) lisäksi ilmaisee mahdollisen ongelman.

7. Ota yhteyttä tukeen , jos vianmääritys on tarpeen.

Hallitut käyttäjätiedot

Joustavan Azure Database for PostgreSQL -palvelimen järjestelmän määrittämä hallittu käyttäjätieto (SAMI) on otettava käyttöön, ja sen on oltava ensisijainen käyttäjätieto. Lisätietoja on artikkelissa Järjestelmälle määritetty hallittu käyttäjätieto joustavalle PostgreSQL-palvelimelle.

Jos SAMI-asetuksen tila poistetaan myöhemmin käytöstä käyttöönoton jälkeen ja otetaan uudelleen käyttöön, joustavan Azure Database for PostgreSQL -palvelimen peilaus Fabric OneLakeen epäonnistuu.

Varmista, että SAMI on käytössä seuraavalla kyselyllä: show azure.service_principal_id;

SAMI-käyttöoikeudet

Älä poista Azure Database for PostgreSQL joustavan palvelimen System Assigned Managed Identity (SAMI) -avustajan käyttöoikeuksia peilatussa Fabric-tietokantakohteessa.

Jos poistat vahingossa SAMI-käyttöoikeudet, joustavan Azure Database for PostgreSQL -palvelimen peilaus ei toimi odotetulla tavalla. Lähdetietokannasta ei voi peilata uusia tietoja.

Jos poistat Azure Database for PostgreSQL joustavan palvelimen SAMI-käyttöoikeuksia tai käyttöoikeuksia ei ole määritetty oikein, toimi seuraavasti.

1. Lisää joustava palvelimen SAMI käyttäjäksi valitsemalla ... peilatun tietokantakohteen kolme pistettä -vaihtoehto.
2. Valitse Hallitse käyttöoikeuksia -vaihtoehto.
3. Kirjoita joustavan Azure Database for PostgreSQL -palvelimen nimi. Anna luku - ja kirjoitusoikeudet .

Liittyvä sisältö

• Microsoft Fabric tietovaraston rajoitukset
• Usein kysyttyjä kysymyksiä Azure Database for PostgreSQL joustavan palvelimen peilaamisesta Microsoft Fabricissa