Feilsøke strukturspeilede databaser fra Azure Database for PostgreSQL fleksibel server

Denne artikkelen dekker feilsøkingstrinn for speiling av Azure Database for PostgreSQL fleksibel server.

Feilsøke feil-/advarselsmeldinger under tabellvalg for speiling

Når du oppretter en ny speilet database, kan det hende du får visuell tilbakemelding om bestemte tabeller i kildedatabasen på siden Velg data . Tabellen nedenfor inneholder en liste over potensielle problemer, inkludert meldingen som vises, og relatert beskrivelse av hvordan du løser problemet.

¹ Objektidentifikatorer med mellomrom (' ') støttes ikke.

² Denne tabelltypen støttes ikke for speiling. For øyeblikket støttes ikke visninger, materialiserte visninger, sekundære tabeller og partisjonerte tabeller. TimescaleDB-hypertabeller støttes heller ikke for Fabric Mirroring.

³ Hvis du vil ha en liste over datatyper som ikke støttes, kan du se Begrensninger. Bare kolonner med følgende typer støttes:

• 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 (* ikke som primærnøkkel)
• 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

I Postgres anses to 'tid med tidssone'-verdier som tilsvarer nøyaktig samme øyeblikk, men i forskjellige tidssoner, som forskjellige. For eksempel: 06:24:00.59+05 og 05:24:00.59+04 tilsvarer samme epoketid, men Postgres behandler dem forskjellig.

Standard ubegrensede numeriske kolonner i kildedatabaseskjemaer (uten definert presisjon og skala) konverteres til Desimal128(38, 0) før de replikeres til OneLake-tabeller, i tråd med SQL-standardkonvensjonen om at uspesifisert skala betyr heltallspresisjon.

Datadefinisjonsspråk (DDL)-operasjoner støttet på kildedatabasen

• Omdøp kolonne: en kolonne med det nye navnet legges til i den speilede tabellen i Fabric og inneholder data for nylig innsatte rader (for eksisterende rader vil være NULL). Den gamle kolonnen opprettholdes fortsatt med verdier for eksisterende rader (for nye rader er NULL).
• Legg til kolonne: Den tilføyde kolonnen er synlig i den speilede tabellen og inneholder data for nylig innsatte rader (for eksisterende rader er NULL).
• Fjern kolonne: fjernet kolonne forblir synlig i den speilede tabellen og inneholder data for eksisterende rader (for nye rader er NULL).
• Endre primærnøkkel: speilingsøkten fortsetter jevnlig.

Enhver annen DDL-operasjon på kildetabeller støttes for øyeblikket ikke og kan forårsake replikeringsfeil.

Endringer i stoffkapasitet eller arbeidsområde

SQL-spørringer for feilsøking

Hvis du opplever speilingsproblemer, koble deg til kildeserveren Azure Database for PostgreSQL og utfør disse sjekkene ved hjelp av systemvisninger og funksjoner for å validere konfigurasjonen.

1. Kjør følgende spørring for å validere om alle forutsetninger er oppfylt før du starter CDC-speilingen. Denne funksjonen sjekker ulike system- og konfigurasjonskrav for å sikre at serveren er klar for CDC-operasjoner.

-- 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"}]

Returer:(status text, data jsonb)

• status: Overordnet status – OK hvis alle sjekker består, ERROR hvis noen prøver feiler
• data: JSONB-array som inneholder detaljerte statusoppføringer med status, status_code, og valgfritt details

Statuskoder:

2. Kjør følgende spørring for å validere om tabeller i kildedatabasen din er kvalifisert for replikasjon. Ekskluderer systemskjemaer (pg_catalog, information_schema, ) pg_toastog utvidelseseide tabeller.

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"}]

Returer: Sett av (table_schema text, table_name text, mirroring_status text, mirroring_data jsonb)

• table_schema: Skjemanavn på tabellen
• table_name: Navnet på tabellen
• mirroring_status: Overordnet status - OK, WARNING, eller ERROR
• mirroring_data: JSONB-array som inneholder detaljerte statusoppføringer med status, status_code, og valgfritt details

Statuskoder:

3. Kjør følgende spørring for å returnere feil og problemer oppdaget under replikeringsoperasjoner, inkludert systemomfattende feil, publikasjonsspesifikke feil og feil per tabell.

-- 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');

Parametere:

• db_name (tekst): Databasenavn
• pub_name (tekst): Publikasjonens navn

Oppførsel:

• Når det kalles med tomme strenger for begge parameterne (azure_cdc.get_health_status('', '')): Returnerer kun systemomfattende feil (feiltype 'S').
• Når den kalles med gyldige database- og publikasjonsnavn: Returnerer både systemomfattende feil og publikasjons-/tabellspesifikke feil for den angitte publikasjonen.

Returer: Sett av (error_time timestamptz, schema_name text, table_name text, error_type char(1), error_code text, params jsonb)

Feiltyper:

Feilkoder:

4. Kjør følgende spørring for å sjekke om publiseringen er opprettet korrekt og at replikasjonen flyter riktig:

   select * from azure_cdc.tracked_publications;
   

   Sjekk om publikasjonen er aktiv og øyeblikksbilde er generert. Du kan også sjekke om etterfølgende endringsgrupper er generert ved å spørre:

   select * from azure_cdc.tracked_batches;
   

5. Hvis visningen azure_cdc.tracked_publications ikke viser noen fremdrift ved behandling av trinnvise endringer, kjører du følgende SQL-spørring for å kontrollere om det er rapportert problemer:

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

6. Hvis det ikke er rapportert noen problemer, utfør følgende kommando for å se gjennom gjeldende konfigurasjon av den speilede PostgreSQL-databasen. Bekreft at den er riktig aktivert.

   SELECT * FROM pg_replication_slots;
   

   Nøkkelkolonnene du vil se etter her, er slot_name og active. Enhver verdi i tillegg til t (sann) indikerer et potensielt problem.

7. Kontakt kundestøtte hvis feilsøking kreves.

Administrert identitet

Den systemtilordnede administrerte identiteten (SAMI) for den fleksible Azure Database for PostgreSQL-serveren må være aktivert, og må være den primære identiteten. Hvis du vil ha mer informasjon, kan du se Systemtilordnet administrert identitet for PostgreSQL fleksibel server.

Etter aktivering, hvis SAMI-innstillingsstatus senere deaktiveres og deretter aktiveres igjen, mislykkes speilingen av Azure Database for PostgreSQL fleksibel server til Fabric OneLake.

Kontroller at SAMI er aktivert med følgende spørring: show azure.service_principal_id;

SAMI tillatelser

Ikke fjern Azure Database for PostgreSQL fleksibel server System Assigned Managed Identity (SAMI)-bidragsytertillatelser på Fabric speilet databaseelement.

Hvis du ved et uhell fjerner SAMI-tillatelser, fungerer ikke speiling av Azure Database for PostgreSQL fleksibel server som forventet. Ingen nye data kan speiles fra kildedatabasen.

Hvis du fjerner Azure Database for PostgreSQL fleksible server-SAMI-tillatelser eller -tillatelser som ikke er riktig konfigurert, bruker du følgende trinn.

1. Legg til den fleksible serveren SAMI som en bruker ved å velge ... ellipsealternativet på det speilede databaseelementet.
2. Velg alternativet Administrer tillatelser .
3. Skriv inn navnet på den fleksible Azure Database for PostgreSQL-serveren. Gi lese - og skrivetillatelser .

Relatert innhold

• Begrensninger for Microsoft Fabric datalager
• Vanlige spørsmål om speiling av fleksibel server for Azure Database for PostgreSQL i Microsoft Fabric