Problemen met Fabric-gedupliceerde databases van de flexibele serverinstantie Azure Database voor PostgreSQL oplossen

In dit artikel worden stappen beschreven voor probleemoplossing voor het spiegelen van flexibele Azure Database for PostgreSQL-servers.

Fout-/waarschuwingsberichten oplossen tijdens het selecteren van tabellen voor spiegeling

Wanneer u een nieuwe gespiegelde database maakt, ontvangt u op de pagina Gegevens kiezen mogelijk visuele feedback over specifieke tabellen in de brondatabase. De volgende tabel bevat een lijst met mogelijke problemen, waaronder het weergegeven bericht en de bijbehorende beschrijving over het oplossen van het probleem.

¹ Object-id's met een spatie (' ') worden niet ondersteund.

² Dit tabeltype wordt niet ondersteund voor spiegeling. Momenteel worden weergaven, gerealiseerde weergaven, buitenlandse tabellen en gepartitioneerde tabellen niet ondersteund. TimescaleDB-hypertabellen worden ook niet ondersteund voor Fabric Mirroring.

³ Zie Beperkingen voor een lijst met niet-ondersteunde gegevenstypen. Alleen kolommen met de volgende typen worden ondersteund:

• 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 (* niet als primaire sleutel)
• 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

In Postgres worden twee 'tijd met tijdzone'-waarden die exact hetzelfde moment overeenkomen, maar in verschillende tijdzones als verschillend beschouwd. Bijvoorbeeld: 06:24:00.59+05 en 05:24:00.59+04 corresponderen met dezelfde tijdsduur, maar Postgres behandelt ze anders.

Standaard ongelimiteerde numerieke kolommen in brondatabaseschema's (zonder gedefinieerde precisie en schaal) worden geconverteerd naar Decimal128(38, 0) voordat ze worden gerepliceerd naar OneLake-tabellen, in overeenstemming met de SQL-standaardconventie waarbij een niet-opgegeven schaal betekent dat er een gehele precisie wordt gehanteerd.

DDL-bewerkingen (Data Definition Language) die worden ondersteund in de brondatabase

• Kolom hernoemen: een kolom met de nieuwe naam wordt toegevoegd aan de gespiegelde tabel in Fabric en zal gegevens bevatten voor nieuw ingevoegde rijen (voor bestaande rijen zal NULL zijn). De oude kolom wordt nog steeds onderhouden met waarden voor de bestaande rijen (voor nieuwe rijen is NULL).
• Kolom toevoegen: toegevoegde kolom is zichtbaar in de gespiegelde tabel en bevat gegevens voor nieuw ingevoegde rijen (voor bestaande rijen zijn NULL).
• Kolom verwijderen: verwijderde kolom blijft zichtbaar in de gespiegelde tabel en bevat gegevens voor bestaande rijen (voor nieuwe rijen is NULL).
• Primaire sleutel wijzigen: de spiegelingssessie wordt regelmatig voortgezet.

Elke andere DDL-bewerking op brontabellen wordt momenteel niet ondersteund en kan replicatiefouten veroorzaken.

Wijzigingen in Fabriccapaciteit of -werkruimte

SQL-query's voor probleemoplossing

Als u problemen ondervindt met spiegelen, maakt u verbinding met de bron-Azure Database for PostgreSQL-server en voert u deze controles uit met behulp van systeemweergaven en -functies om de configuratie te valideren.

1. Voer de volgende query uit om te controleren of aan alle vereisten wordt voldaan voordat je CDC-spiegeling start. Met deze functie worden verschillende systeem- en configuratievereisten gecontroleerd om ervoor te zorgen dat de server gereed is voor CDC-bewerkingen.

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

Retourneert:(status text, data jsonb)

• status: Algemene status : OK als alle controles zijn geslaagd, ERROR als er een controle mislukt
• data: JSONB-matrix met gedetailleerde statusvermeldingen met status, status_codeen optioneel details

Statuscodes:

2. Voer de volgende query uit om te controleren of tabellen in uw brondatabase in aanmerking komen voor replicatie. Hiermee worden systeemschema's (pg_catalog, information_schema, , pg_toast) en tabellen in eigendom van extensies uitgesloten.

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

Retourneert: Set van (table_schema text, table_name text, mirroring_status text, mirroring_data jsonb)

• table_schema: Schemanaam van de tabel
• table_name: Naam van de tabel
• mirroring_status: Algemene status - OK, WARNING, of ERROR
• mirroring_data: JSONB-matrix met gedetailleerde statusvermeldingen met status, status_codeen optioneel details

Statuscodes:

3. Voer de volgende query uit om fouten en problemen te retourneren die zijn gedetecteerd tijdens replicatiebewerkingen, inclusief systeemfouten, publicatiespecifieke fouten en fouten per tabel.

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

Parameters:

• db_name (tekst): Databasenaam
• pub_name (tekst): Publicatienaam

Gedrag:

• Wanneer aangeroepen met lege tekenreeksen voor beide parameters (azure_cdc.get_health_status('', '')): retourneert alleen systeembrede fouten (fouttype 'S').
• Wanneer deze wordt aangeroepen met geldige database- en publicatienamen: retourneert zowel systeembrede fouten als publicatie-/tabelspecifieke fouten voor de opgegeven publicatie.

Retourneert: Set van (error_time timestamptz, schema_name text, table_name text, error_type char(1), error_code text, params jsonb)

Fouttypen:

Foutcodes:

4. Voer de volgende query uit om te controleren of de publicatie juist is gemaakt en of de replicatie juist verloopt.

   select * from azure_cdc.tracked_publications;
   

   Controleer of de publicatie actief is en er een momentopname is gegenereerd. U kunt ook controleren of volgende wijzigingsbatches zijn gegenereerd door query's uit te voeren:

   select * from azure_cdc.tracked_batches;
   

5. Als in de azure_cdc.tracked_publications weergave geen voortgang wordt weergegeven bij het verwerken van incrementele wijzigingen, voert u de volgende SQL-query uit om te controleren of er problemen zijn gerapporteerd:

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

6. Als er geen problemen zijn gerapporteerd, voert u de volgende opdracht uit om de huidige configuratie van de gespiegelde PostgreSQL-database te controleren. Controleer of deze juist is ingeschakeld.

   SELECT * FROM pg_replication_slots;
   

   De belangrijkste kolommen die u hier kunt zoeken, zijn de slot_name en active. Elke waarde naast t (true) geeft een potentieel probleem aan.

7. Neem contact op met de ondersteuning als probleemoplossing is vereist.

Beheerde identiteit

De door het systeem toegewezen beheerde identiteit (SAMI) van de flexibele Azure Database for PostgreSQL-server moet zijn ingeschakeld en moet de primaire identiteit zijn. Zie De door het systeem toegewezen beheerde identiteit voor flexibele PostgreSQL-server voor meer informatie.

Als na het inschakelen de SAMI-instellingsstatus later is uitgeschakeld en opnieuw is ingeschakeld, mislukt het spiegelen van flexibele Azure Database for PostgreSQL-server naar Fabric OneLake.

Controleer of de SAMI is ingeschakeld met de volgende query: show azure.service_principal_id;

SAMI-machtigingen

Verwijder geen bijdragerrechten van Azure Database for PostgreSQL Flexible Server System Assigned Managed Identity (SAMI) van het gespiegelde database-item van Fabric.

Als u per ongeluk SAMI-machtigingen verwijdert, werkt het spiegelen van Azure Database for PostgreSQL - flexibele server niet zoals verwacht. Er kunnen geen nieuwe gegevens worden gespiegeld vanuit de brondatabase.

Als u SAMI-machtigingen voor de flexibele server van Azure Database for PostgreSQL verwijdert of deze niet correct zijn ingesteld, volgt u de volgende stappen.

1. Voeg de flexibele server SAMI toe als gebruiker door de ... optie beletselteken op het gespiegelde database-item te selecteren.
2. Selecteer de optie Machtigingen beheren .
3. Voer de naam in van de flexibele Azure Database for PostgreSQL-server. Geef lees - en schrijfmachtigingen op.

Verwante inhoud

• Beperkingen van Microsoft Fabric Data Warehouse
• Veelgestelde vragen over het spiegelen van een flexibele Azure Database for PostgreSQL-server in Microsoft Fabric