SYNCED_TABLE_USER_ERROR Fehlersituation

SQLSTATE: 42000

Benutzerfehler der synchronisierten Tabellenpipeline.

ACCELERATED_SYNC_DATA_TOO_LARGE

Die synchronisierte Tabelle <tableName> hat zu viele große Spaltenwerte, um beschleunigte Synchronisation zu verwenden.

Für eine neue synchronisierte Tabelle deaktivieren Sie die beschleunigte Synchronisation beim Erstellen aus der Benutzeroberfläche.

Für eine bestehende synchronisierte Tabelle wenden Sie sich an den Support von Azure Databricks.

ACTIVE_ENDPOINTS_LIMIT

Instanz: <instance>. Das Datenbankprojekt hat seine Grenze an gleichzeitig aktiven Endpunkten überschritten, sodass die synchronisierte Tabellenpipeline keine Verbindung herstellen kann. Details: <detail>.

Um dieses Problem zu lösen, reduzieren Sie die Anzahl der gleichzeitig aktiven Endpunkte oder erhöhen Sie das Limit für Ihr Projekt.

ACTIVE_TIME_QUOTA_EXCEEDED

Instanz: <instance>. Das Datenbankprojekt hat seine aktive Zeitquote überschritten, sodass die synchronisierte Tabellenpipeline keine Verbindung herstellen kann. Details: <detail>.

Um dieses Problem zu lösen, erhöhen Sie die aktive Zeitquote für Ihr Projekt.

BRANCH_COMPUTE_TIME_EXCEEDED

Instanz: <instance>. Der Datenbankbranch hat seine Rechenzeit überschritten, sodass die synchronisierte Tabellenpipeline keine Verbindung herstellen kann. Details: <detail>.

Um dieses Problem zu lösen, erhöhen Sie die verfügbare Rechenzeit für diesen Zweig.

GEÄNDERTER_PRIMÄRSCHLÜSSEL

Die für die synchronisierte Tabelle <destTableUcName> angegebenen Primärschlüsselspalten wurden geändert.

Angegebene Primärschlüsselspalten: (<primaryKeyColumns>). Aktuelle Primärschlüsselspalten: (<existingPrimaryKeyColumns>).

Das Ändern der Primärschlüsselspalten einer synchronisierten Tabelle nach der Erstellung wird nicht unterstützt.

Um dieses Problem zu beheben, ändern Sie entweder die synchronisierte Tabelle wieder in die ursprünglichen Primärschlüsselspalten, oder erstellen Sie eine neue synchronisierte Tabelle, und legen Sie die vorhandene Tabelle ab.

GEÄNDERTER_PRIMARY_KEY_SPALTENTYP

Die Datentypen von Primärschlüsselspalten <modifiedPkColumns> wurden in der synchronisierten Tabelle <destTableUcName>geändert.

Das Ändern der Datentypen von Primärschlüsselspalten wird nach der Erstellung in einer synchronisierten Tabelle nicht unterstützt.

Um dieses Problem zu beheben, erstellen Sie eine neue synchronisierte Tabelle, und legen Sie die vorhandene Tabelle ab.

ZEICHEN_NICHT_IM_REPERTOIRE

Instanz: <instance>. In der Quell-Delta-Tabelle wurde eine ungültige Bytesequenz gefunden.

Details: <detail>

Dies gibt in der Regel an, dass die Delta-Quelltabelle Zeichen enthält, die nicht

kompatibel mit der Codierung der Zieldatenbank. Eine Problemumgehung besteht darin, die Datei zu konvertieren.

Legen Sie für die Quelltabelle den Type BINARY fest und erstellen Sie dann eine neue synchronisierte Tabelle.

ÄNDERUNG_DES_SPALTENTYPS_NICHT_UNTERSTÜTZT

Instanz: <instance>. Das Ändern des Spaltentyps wird derzeit nicht unterstützt.

Quell-Delta-Tabelle: <srcTableName>. Zielsynchronisierungstabelle: <destTableName>.

Spalte: <columnName>. Vorhandener Typ: <existingType>. Neuer Typ: <newType>.

Um dieses Problem zu beheben, sollten Sie eine der folgenden Optionen in Betracht ziehen:

  1. Führen Sie eine vollständige Aktualisierung der vorhandenen synchronisierten Tabelle aus.

  2. Erstellen einer neuen synchronisierten Tabelle (die den neuen Typ übernimmt)

COMPUTE_TIME_QUOTA_EXCEEDED

Instanz: <instance>. Das Datenbankkonto oder -projekt hat seine Rechenzeit-Quote überschritten, sodass die synchronisierte Tabellenpipeline keine Verbindung herstellen kann. Details: <detail>.

Um dieses Problem zu lösen, erhöhen Sie die Rechenzeit-Quote für Ihr Konto oder Projekt.

Verbindungsfehler

Instanz: <instance>. Verbindungsfehler. Details: <detail>.

Um dieses Problem zu beheben, stellen Sie sicher, dass die Datenbankinstanz ausgeführt wird, nicht angehalten oder beendet wird.

Starten Sie die Pipeline neu, um den Vorgang erneut zu versuchen.

DATENBANK_EXISTIERT_NICHT

Die Zieldatenbank <databaseName> ist in Lakebase-Instanz <instance>nicht vorhanden. Überprüfen Sie, ob die Zieldatenbank vorhanden ist.

DATABASE_ROLE_NOT_EXIST

Instanz: <instance>. Die Postgres-Rolle <roleName> , von der die synchronisierte Tabellenpipeline abhängt, existiert nicht. Details: <detail>.

Dies geschieht typischerweise, wenn die Rolle aus der Datenbankinstanz gelöscht wurde, zum Beispiel nachdem die Identität aus dem Arbeitsbereich entfernt wurde.

Um dieses Problem zu lösen, erstellen Sie die Postgres-Rolle <roleName> auf der Datenbankinstanz neu oder lassen Sie die synchronisierte Tabelle fallen und erstellen Sie sie mit einer Identität, die noch existiert.

DATA_TRANSFER_QUOTA_EXCEEDED

Instanz: <instance>. Das Datenbankprojekt hat seine Datenübertragungsquote überschritten, sodass die synchronisierte Tabellenpipeline keine Verbindung herstellen kann. Details: <detail>.

Um dieses Problem zu lösen, erhöhen Sie die Datenübertragungsquote für Ihr Projekt.

DELTA_TRUNCATED_TRANSACTION_LOG

Details: <detail>.

Dies weist darauf hin, dass das Transaktionsprotokoll der Delta-Tabelle aufgrund manueller Löschung oder der Protokollaufbewahrungsrichtlinie gekürzt wurde.

Führen Sie eine vollständige Aktualisierung der synchronisierten Tabelle aus, um dieses Problem zu beheben.

ABHÄNGIGE_OBJEKTE_EXISTIEREN_NOCH

Instanz: <instance>. Es kann keine Spalte gelöscht werden, da eine vorhandene Abhängigkeit besteht.

Das PostgreSQL-Objekt verweist weiterhin auf die Spalte. Details: <detail>.

Um dieses Problem zu beheben, sollten Sie eine der folgenden Optionen in Betracht ziehen:

  1. Fügen Sie die fehlenden Spalten zurück zur Quelltabelle mit demselben Datentyp(n) wie zuvor hinzu.

  2. Legen Sie die abhängigen Objekte in PostgreSQL ab.

DESTINATION_NAME_NOT_A_TABLE

Instanz: <instance>. Synchronisierte Tabelle <destTableUcName> kann nicht erstellt werden, da ihr Zielname bereits von einer <objectType> in der Zieldatenbank verwendet wird.

Die synchronisierte Tabellenpipeline erstellt oder verwaltet dieses Objekt nicht.

Lassen Sie die bestehende <objectType>Karte fallen oder benennen Sie sie um, oder erstellen Sie die synchronisierte Tabelle mit einem anderen Namen und versuchen Sie es dann erneut.

DESTINATION_SCHEMA_ACCESS_ERROR

Instanz: <instance>. Die synchronisierte Tabellenpipeline hat keine Berechtigung für das Zielschema <schemaName>. Details: <detail>.

Die Pipeline verbindet sich als Postgres-Rolle <databaseUser>, die und auf das Zielschema benötigt USAGECREATE , um die Zieltabelle zu erstellen und zu pflegen.

Um dieses Problem zu lösen, führen Sie aus: GRANT USAGE, CREATE ON SCHEMA <quotedSchemaName> TO <quotedDatabaseUser>; und starten Sie dann die Pipeline neu.

DOPPELTE_PRIMÄRSCHLÜSSELSPALTEN

Spalten <duplicatedPkColumns> werden mehrmals im Primärschlüssel für die synchronisierte Tabelle <destTableUcName>angegeben.

Um dieses Problem zu beheben, entfernen Sie die doppelten Spalten aus dem Primärschlüssel, sodass jede Spalte nur einmal angezeigt wird.

ENDPOINT_DISABLED

Instanz: <instance>. Die Zieldatenbankinstanz wurde deaktiviert und kann keine Verbindungen mehr akzeptieren. Details: <detail>.

Dies geschieht typischerweise, wenn die Instance gestoppt wurde. Eine deaktivierte Instanz kann nicht durch einen Verbindungsversuch gestartet werden.

Um dieses Problem zu beheben, aktivieren oder starten Sie die Datenbankinstanz erneut und starten Sie dann die Pipeline neu.

Wenn die Instanz absichtlich gestoppt wurde, pausieren oder löschen Sie stattdessen die synchronisierte Tabelle.

ENDPOINT_NOT_FOUND

Instanz: <instance>. Der Ziel-Datenbank-Endpunkt konnte nicht gefunden werden oder ist nicht zugänglich. Details: <detail>.

Um dieses Problem zu lösen, überprüfen Sie, ob die Datenbankinstanz existiert und die synchronisierte Tabelle mit der richtigen Instanz konfiguriert ist.

FOREIGN_KEY_CONSTRAINT_VIOLATION

Instanz: <instance>. Verletzung der Fremdschlüsseleinschränkung beim Synchronisieren aus der Quelltabelle:

<srcTableName>. Details: <detail>

Das Erstellen von Fremdschlüsseleinschränkungen, die auf Synchronisierungstabellen verweisen, wird nicht unterstützt. Bitte

legen Sie die Fremdschlüsseleinschränkung ab, und wiederholen Sie die Synchronisierung.

INDEX_ZEILENGRÖSSE_ÜBERSCHRITTEN

Instanz: <instance>. Die Primärschlüsselwerte in der Quell-Delta-Tabelle <srcTableName> sind zu groß für die

PostgreSQL B-Tree Index. PostgreSQL schränkt Indexeinträge auf ca. 2704 Bytes über alle Primärschlüssel ein

Spalten kombiniert. Details: <detail>.

Um dieses Problem zu beheben, verringern Sie die Größe der in den Primärschlüsselspalten gespeicherten Daten, oder verwenden Sie weniger oder

kürzere Primärschlüsselspalten.

UNZUREICHENDER_INSTANZRAUM

Die Synchronisierungstabelle <tableName> kann aufgrund der Datenbankgröße nicht in einer Instanz <instance> ausgeführt werden.

Aktuelle Instanznutzung: <instanceSize> Bytes.

Geschätzte nicht komprimierte Tabellengröße: <estimatedLoadSize> Bytes.

Grenzwert für die Instanzengröße: <maxInstanceSize> Bytes.

Reduzieren Sie die zu synchronisierende Datenmenge, oder legen Sie einige vorhandene Tabellen in der Instanz ab, um Speicherplatz freizugeben.

INVALID_ENDPOINT

Instanz: <instance>. Die Datenbankinstanz hat die Verbindung abgelehnt, weil der angeforderte Endpunkt für diese Operation nicht gültig ist. Details: <detail>.

Dies kann passieren, wenn schreibgeschützte Verbindungen nicht erlaubt sind oder die angeforderte Berechnung nicht existiert.

Um dieses Problem zu beheben, überprüfen Sie die Zielinstanz- und Endpunktkonfiguration der synchronisierten Tabelle und starten Sie anschließend die Pipeline neu.

INVALID_TABLE_NAME

Ungültiger Tabellenname: <tableName>Erwarteter dreiteiliger Name (catalog.schema.table).

INVALID_TYPE_OVERRIDE

Instanz: <instance>. Ungültige Typ-Übersteuerung für Spalte <columnName>: <reason>.

INVALID_VECTOR_DATA

Ungültige Vektordaten für die Spalte <columnName>: <reason>.

IP_NOT_ALLOWED

Instanz: <instance>. Die IP-Adresse der synchronisierten Tabellen-Pipeline darf sich nicht mit der Datenbankinstanz verbinden. Details: <detail>.

Um dieses Problem zu beheben, aktualisieren Sie die IP-Berechtigungsliste der Datenbankinstanz, um die Verbindung zu ermöglichen.

LOCK_TIMEOUT

Instanz: <instance>. Datenbank: <databaseName>. Die Pipeline für synchronisierte Tabellen konnte innerhalb des konfigurierten Timeouts (<timeoutSeconds> Sekunden) keine Sperre erhalten.

Erkannte <numBlockingTransactions> Transaktionen, die Sperren in der Zieltabelle enthalten (maximale Sperrdauer: <lockDurationSeconds> Sekunden).

Benutzertransaktionen halten Sperren, die die synchronisierte Tabellen-Pipeline blockieren und dadurch die Aktualisierung der Zieltabelle verhindern.

Weitere Informationen zu den Transaktionen, die an dem Fehler beteiligt sind, finden Sie in den Spark-Treiberprotokollen (suchen Sie nach '[LOCK TIMEOUT DIAGNOSTICS]').

Um dieses Problem zu beheben, suchen Sie die Verbindungen mit langen Transaktionen in der Postgres-Instanz mithilfe von pg_stat_activity, und schließen Sie diese Transaktionen (kann auch pg_terminate_backend verwenden, um die Verbindung zu beenden, wenn die Verbindung nicht mehr benötigt wird).

Um zu verhindern, dass dieses Problem in Zukunft auftritt, sollten Sie die folgenden Optionen berücksichtigen:

  1. Stellen Sie sicher, dass Ihre Anwendung entweder die Transaktion bestätigt oder rückgängig macht.

  2. Vermeiden Sie lang andauernde Transaktionen. Legen Sie auto_commit auf "Ein" fest, wenn die Arbeit in der Anwendung nicht in einer Transaktion erfolgen muss.

  3. Legen Sie idle_in_transaction_session_timeout für die Datenbank fest, um Leerlauftransaktionen automatisch zu beenden.

Beispiel: ALTER DATABASE <databaseName> SET idle_in_transaction_session_timeout = '5min';

LOGICAL_SIZE_QUOTA_EXCEEDED

Instanz: <instance>. Das Datenbankprojekt hat seine logische Größenquote überschritten, sodass die synchronisierte Tabellenpipeline keine Verbindung herstellen kann. Details: <detail>.

Um dieses Problem zu lösen, erhöhen Sie die logische Größenquote für Ihr Projekt oder reduzieren Sie die Menge der gespeicherten Daten.

FEHLKONFIGURIERTER_PRIMÄRSCHLÜSSEL

Die bereitgestellten Primärschlüssel für die Quell-Delta-Tabelle: <srcTableName> Sind in der Quelltabelle nicht verfügbar.

Primärschlüssel: <primaryKeys>. Verfügbare Spalten: <availableColumns>. Fehlende Primärschlüssel: <missingPkColumns>.

Um dieses Problem zu beheben, sollten Sie eine der folgenden Optionen in Betracht ziehen:

  1. Fügen Sie der Quelltabelle die fehlenden Spalten hinzu.

  2. Erstellen Sie eine neue synchronisierte Tabelle mit der richtigen Primärschlüsselkonfiguration.

NATIVE_LOGIN_BLOCKED

Instanz: <instance>. Der native (Passwort-)Login ist für die Datenbankrolle, die von der synchronisierten Tabellenpipeline verwendet wird, deaktiviert. Details: <detail>.

Um dieses Problem zu lösen, aktivieren Sie den nativen Login für die Datenbankrolle der Pipeline oder konfigurieren Sie die Rolle so um, dass sie eine unterstützte Authentifizierungsmethode verwendet.

NETWORK_BLOCKED

Instanz: <instance>. Die synchronisierte Tabellenpipeline darf sich nicht von ihrem Netzwerk aus mit der Datenbankinstanz verbinden. Details: <detail>.

Um dieses Problem zu beheben, aktualisieren Sie die Netzwerkzugriffskonfiguration der Datenbankinstanz, um die Verbindung zu ermöglichen.

PERMISSION_DENIED

Details: <detail>.

Überprüfen Sie, ob Sie über ausreichende Berechtigungen verfügen.

PIPELINE_ROLLE_EXISTIERT_NICHT

Instanz: <instance>. Die Datenbankschreiberrolle für die Pipeline für synchronisierte Tabellen fehlt. Details: <detail>.

Dies tritt in der Regel auf, wenn die Zieldatenbank gelöscht wurde, wodurch die Writer-Rolle der Pipeline entfernt wird.

Um dieses Problem zu beheben, überprüfen Sie, ob die Zieldatenbank vorhanden ist und nicht gelöscht wurde.

Wenn die Datenbank absichtlich gelöscht wurde, löschen Sie die synchronisierte Tabelle, und erstellen Sie sie nach dem Erneuten Erstellen der Datenbank neu.

PRIMARY_KEY_CONSTRAINT_VIOLATION

Instanz: <instance>. Doppelte Zeilen, die basierend auf dem Primärschlüssel erkannt wurden. Details: <detail>

Dies deutet wahrscheinlich auf eine Fehlkonfiguration von Primärschlüsselspalten hin.

Überprüfen Sie, ob Sie den richtigen Satz von Primärschlüsseln verwenden.

aus der Quell-Delta-Tabelle: <srcTableName>.

Um dieses Problem zu beheben, erstellen Sie eine neue synchronisierte Tabelle mit der richtigen

Primärschlüsselkonfiguration.

QUOTA_EXCEEDED

Instanz: <instance>. Das Ziel-Datenbankkonto oder -projekt hat seine Quote überschritten. Details: <detail>.

Um dieses Problem zu lösen, reduzieren Sie die Nutzung oder aktualisieren Sie den Plan, um die Quote zu erhöhen, und starten Sie dann die Pipeline neu.

REFRESH_WITH_FOREIGN_KEY

Instanz: <instance>. Fehler beim Aktualisieren der synchronisierten Tabelle <destTableName>, da die Tabelle nicht aktualisiert werden konnte.

<childTableName> verfügt über eine Fremdschlüsseleinschränkung, die auf die synchronisierte Tabelle verweist.

Das Aktualisieren der synchronisierten Tabelle wird nicht unterstützt, wenn Fremdschlüsseleinschränkungen vorhanden sind.

verweisend darauf. Bitte legen Sie die Fremdschlüsseleinschränkung ab, und wiederholen Sie die Aktualisierung.

REQUIRED_EXTENSION_NOT_INSTALLED

Instanz: <instance>. Die erforderliche PostgreSQL-Erweiterung '<extension>' ist nicht installiert. Installiere es in der Lakebase-Instanz, bevor du diese Synchronisation erstellst.

SCHEMA_BUILDER_NOT_ENABLED

Synchronisierte Tabellenschema-Anpassung (<features>) ist für diesen Arbeitsbereich nicht aktiviert.

SCHEMA_EXISTIERT_NICHT

Details: <detail>.

Überprüfen Sie, ob das Schema im Unity-Katalog vorhanden ist.

QUELLEN-LESEFEHLER

Fehler beim Lesen aus der Quelltabelle <tableName>. Überprüfen Sie, ob die Quelltabelle erfolgreich über eine SELECT Abfrage gelesen werden kann.

Details: <detail>

SOURCE_SMART_CLONE_REQUIRED

Die Quellmaterialisierungsansicht <srcTableName> erfordert, dass SmartClone aktiviert ist, bevor sie als synchronisierte Tabellenquelle verwendet werden kann. Lauf REPAIR TABLE <srcTableName> SYNC METADATA und versuch es erneut.

SPARK_JOB_CANCELLED

Der Spark-Auftrag wird abgebrochen.

Details: <detail>

SYSTEM_SPALTENNAME_KONFLIKT

Instanz: <instance>. Die Quell-Delta-Tabelle <srcTableName> enthält eine Spalte, deren Name mit einem PostgreSQL-Systemspaltennamen in Konflikt steht. Details: <detail>.

PostgreSQL reserviert bestimmte Spaltennamen (z. B. xmin, xmax, ctid, cmin, cmax, tableoid) zur internen Verwendung.

Um dieses Problem zu beheben, benennen Sie die konfliktierende Spalte in der Quell-Delta-Tabelle um, und erstellen Sie die synchronisierte Tabelle neu.

Oder erstellen Sie eine Ansicht mit den ausgeschlossenen konfliktierenden Spalten, und synchronisieren Sie stattdessen die Ansicht.

SYSTEM_SCHEMA_ZUGRIFFSFEHLER

Instanz: <instance>. Das interne Systemschema (__db_system) ist für die synchronisierte Tabellenpipeline nicht zugänglich. Details: <detail>.

Dies kann passieren, wenn die Datenbank zurückgesetzt oder das interne Schema gelöscht und ohne ordnungsgemäße Berechtigungen neu erstellt wurde.

Um dieses Problem zu beheben, legen Sie die synchronisierte Tabelle <destTableUcName>ab, und erstellen Sie sie neu.

TABLE_EXISTIERT_NICHT

Details: <detail>.

Überprüfen Sie, ob die synchronisierte Tabelle im Unity-Katalog vorhanden ist.

TARGET_DATABASE_FULL

Der Zieldatenbankbereich <databaseName> ist voll. Die Erfassung kann nicht fortgesetzt werden.

ZU_VIELE_VERBINDUNGEN

Zu viele geöffnete Verbindungen mit der Datenbankinstanz: <instance>

Details: <detail>.

Jede Tabellensynchronisierung kann bis zu 16 Verbindungen mit der Datenbankinstanz verwenden, die zum Verbindungsgrenzwert der Instanz zählen.

Um dieses Problem zu beheben, probieren Sie die folgenden Optionen aus:

  1. Verringern Sie die Anzahl gleichzeitiger Pipelines, die in dieselbe Datenbankinstanz geschrieben werden.

Sie können z. B. die Pipeline-Zeitpläne staffeln.

  1. Verringern Sie die Anzahl gleichzeitiger Verbindungen von anderen Workloads, die eine Verbindung mit derselben Datenbankinstanz herstellen.

UNSUPPORTED_COLUMN_TYPE

Instanz: <instance>. Nicht unterstützter PostgreSQL-Spaltentyp: <columnType>.

UNTRANSLATABLE_CHARACTER

Instanz: <instance>. Es wurde ein nicht übersetzbares Zeichen in der Quell-Delta-Tabelle gefunden.

Details: <detail>

Dies gibt in der Regel an, dass die Delta-Quelltabelle Zeichen enthält, die nicht

kompatibel mit der Codierung der Zieldatenbank. Eine Problemumgehung besteht darin, die Datei zu konvertieren.

Legen Sie für die Quelltabelle den Type BINARY fest und erstellen Sie dann eine neue synchronisierte Tabelle.

VPC_ENDPOINT_NOT_ALLOWED

Instanz: <instance>. Der VPC-Endpunkt der synchronisierten Tabellen-Pipeline darf sich nicht mit der Datenbankinstanz verbinden. Details: <detail>.

Um dieses Problem zu lösen, fügen Sie den VPC-Endpunkt der erlaubten Liste der Datenbankinstanz hinzu.

WRITTEN_DATA_QUOTA_EXCEEDED

Instanz: <instance>. Das Datenbankprojekt hat seine geschriebene Datenquote überschritten, sodass die synchronisierte Tabellenpipeline keine Verbindung herstellen kann. Details: <detail>.

Um dieses Problem zu lösen, erhöhen Sie die schriftliche Datenquote für Ihr Projekt.