Mit Sammlungen den Überblick behalten
Sie können Inhalte basierend auf Ihren Einstellungen speichern und kategorisieren.
Die DNS-Auflösung ist in privaten Instanzen verfügbar, die in Cloud Data Fusion Version 6.7.0 oder höher ausgeführt werden. Damit können Sie Hostnamen oder Domainnamen für Quellen und Senken verwenden, wenn Sie Ihre Pipeline in einer privaten Cloud Data Fusion-Instanz entwerfen. So müssen Sie die Pipelinedefinition während des Failovers nicht ändern.
Andernfalls verwenden Sie hartcodierte IP-Adressen, was problematisch ist, wenn sich die Adressen bei einem Failover in hochverfügbaren Bereitstellungen ändern. Die DNS-Auflösung wird empfohlen, wenn Sie eine Pipeline in einer privaten Instanz entwerfen und Schema abrufen, Vorschauen ausführen, Daten aufbereiten und Verbindungen testen möchten.
Erstellen Sie eine private Instanz in Cloud Data Fusion und richten Sie mit den folgenden Schritten ein VPC-Netzwerk oder ein freigegebenes VPC-Netzwerk in der Instanz ein.
Cloud Data Fusion verwendet VPC-Netzwerk-Peering, um eine Netzwerkverbindung zu Ihrem VPC- oder freigegebenen VPC-Netzwerk herzustellen. Dadurch kann Cloud Data Fusion über interne IP-Adressen auf Ressourcen in Ihrem Netzwerk zugreifen.
Gehen Sie beim Einrichten so vor:
Geben Sie einen Namen für die Peering-Verbindung ein.
Wählen Sie unter Mein VPC-Netzwerk das Netzwerk aus, in dem Sie die Cloud Data Fusion-Instanz erstellt haben.
Wählen Sie für Peering-VPC-Netzwerk die Option In einem anderen Projekt aus.
Geben Sie unter VPC-NetzwerknameINSTANCE_REGION-INSTANCE_ID ein.
Ersetzen Sie Folgendes:
INSTANCE_REGION: Die Region, in der Sie die Cloud Data Fusion-Instanz erstellt haben.
INSTANCE_ID: die ID der Cloud Data Fusion-Instanz.
Klicken Sie unter Benutzerdefinierte Routen austauschen auf Benutzerdefinierte Routen exportieren. Auf diese Weise können benutzerdefinierte Routen, die in Ihrem VPC-Netzwerk definiert sind, mit dem Mandanten-VPC-Netzwerk ausgetauscht werden.
Klicken Sie auf Erstellen.
Wenn das VPC-Netzwerk-Peering erfolgreich eingerichtet wurde, ist der Status auf der Seite mit den VPC-Netzwerkdetails Aktiv.
Verwaltete private DNS-Zone erstellen
Wenn Sie Domainnamen in Cloud Data Fusion auflösen möchten, erstellen Sie eine neue verwaltete private DNS-Zone im selben VPC-Netzwerk oder freigegebenen VPC-Netzwerk, das für das VPC-Netzwerk-Peering verwendet wurde. Weitere Informationen finden Sie unter Private Zone erstellen.
Konsole
So erstellen Sie eine private verwaltete DNS-Zone:
Rufen Sie in der Google Cloud Console die Seite DNS-Zone erstellen auf.
Wählen Sie unter Netzwerke das VPC-Netzwerk oder das freigegebene VPC-Netzwerk aus, das für das VPC-Netzwerk-Peering verwendet wurde.
Klicken Sie auf Erstellen.
Datensatz in der DNS-Zone erstellen
Erstellen Sie den Datensatz in der DNS-Zone mit den internen IP-Adressen, die beim Entwerfen der Pipeline aufgelöst werden sollen. Weitere Informationen finden Sie unter Eintrag hinzufügen.
Konsole
So erstellen Sie den Datensatz:
Rufen Sie in der Google Cloud Console die Seite Cloud DNS auf.
Klicken Sie auf die Zone, für die Sie einen Ressourcendatensatz erstellen möchten.
Klicken Sie auf der Seite Zonendetails auf Standard hinzufügen.
Geben Sie für DNS-Name einen Domainnamen ein, der während der Designzeit aufgelöst werden muss.
Geben Sie die Details zum Eintragstyp ein. Geben Sie für die IPv4-Adresse die interne IP-Adresse für die Senke oder Quelle an, die in der Pipeline verwendet werden soll. Weitere Informationen zu Eintragstypen finden Sie unter Eintrag hinzufügen.
Klicken Sie auf Erstellen.
DNS-Peering in einer Instanz hinzufügen
Konsole
So erstellen Sie DNS-Peering in der Google Cloud Console:
Öffnen Sie die Instanz.
Rufen Sie in der Google Cloud Console die Seite „Cloud Data Fusion“ auf.
Klicken Sie auf Instanzen und dann auf den Namen der Instanz, um die Seite Instanzdetails aufzurufen.
Erforderliche Rollen für freigegebene VPC-Netzwerke
Damit das Cloud Data Fusion-Dienstkonto die erforderlichen Berechtigungen zum Erstellen eines DNS-Peerings in einem freigegebenen VPC-Netzwerk hat, bitten Sie Ihren Administrator, dem Cloud Data Fusion-Dienstkonto die IAM-Rolle DNS-Peer (roles/dns.peer) für das freigegebene VPC-Hostprojekt zuzuweisen.
Ihr Administrator kann dem Cloud Data Fusion-Dienstkonto möglicherweise auch die erforderlichen Berechtigungen über benutzerdefinierte Rollen oder andere vordefinierte Rollen erteilen.
[[["Leicht verständlich","easyToUnderstand","thumb-up"],["Mein Problem wurde gelöst","solvedMyProblem","thumb-up"],["Sonstiges","otherUp","thumb-up"]],[["Schwer verständlich","hardToUnderstand","thumb-down"],["Informationen oder Beispielcode falsch","incorrectInformationOrSampleCode","thumb-down"],["Benötigte Informationen/Beispiele nicht gefunden","missingTheInformationSamplesINeed","thumb-down"],["Problem mit der Übersetzung","translationIssue","thumb-down"],["Sonstiges","otherDown","thumb-down"]],["Zuletzt aktualisiert: 2025-09-04 (UTC)."],[[["\u003cp\u003eDNS resolution, available in Cloud Data Fusion version 6.7.0 or later in private instances, enables the use of hostnames or domain names for pipeline sources and sinks, eliminating the need to change pipeline definitions during failover.\u003c/p\u003e\n"],["\u003cp\u003eTo use DNS resolution, create a private Cloud Data Fusion instance (version 6.7.0 or later), set up VPC Network Peering, create a managed private DNS zone, and add record sets with internal IP addresses for domain name resolution.\u003c/p\u003e\n"],["\u003cp\u003eDNS peering can be added to a Cloud Data Fusion instance through the console or the REST API, by providing a DNS peering ID, domain name, target project, and network.\u003c/p\u003e\n"],["\u003cp\u003eIn shared VPC networks, DNS resolution requires creating private zones in the host project or setting them up in a service project with cross-project binding, and the Cloud Data Fusion Service Account needs the \u003ccode\u003eroles/dns.peer\u003c/code\u003e IAM role.\u003c/p\u003e\n"]]],[],null,["# Resolve domain names or hostnames\n\nDNS resolution is available in private instances running in\nCloud Data Fusion version 6.7.0 or later. It lets you use hostnames or\ndomain names for sources and sinks when you design your pipeline in a private\nCloud Data Fusion instance so that you don't have to change the pipeline\ndefinition during failover.\n\nWithout it, you use hard-coded IP addresses, which are problematic when the\naddresses change in the event of a failover in highly-available deployments. DNS\nresolution is recommended when you design a pipeline in a private instance and\nwant to retrieve schema, run previews, wrangle, and test connections.\n| **Note:** Internal IP address resolution is also available with VPC Peering in all Cloud Data Fusion versions.\n\nFor more information, see\n[DNS resolution in Cloud Data Fusion](/data-fusion/docs/concepts/networking#dns-resolution).\n\nBefore you begin\n----------------\n\n### Create a private instance\n\nCreate a private instance in Cloud Data Fusion and set up a VPC network or\nshared VPC network in the instance with the following steps.\n\n1. [Create a private Cloud Data Fusion instance](/data-fusion/docs/how-to/create-private-ip).\n When you create the instance, choose the following options:\n\n 1. Choose version 6.7.0 or later.\n 2. In the **Network** field, choose the appropriate associated network for the private connection.\n 3. Enter any other instance details and click **Create** . For information about all fields, see [Create a private Cloud Data Fusion instance](/data-fusion/docs/how-to/create-private-ip).\n2. [Set up VPC Network Peering](/data-fusion/docs/how-to/create-private-ip#set-up-vpc-peering).\n\n Cloud Data Fusion uses VPC Network Peering to establish network\n connectivity to your VPC or shared VPC network. This lets\n Cloud Data Fusion access resources on your network through internal IP\n addresses.\n\n When you set it up, do the following:\n 1. Enter a **Name** for your peering connection.\n 2. For **Your VPC network**, choose the network where you created your Cloud Data Fusion instance.\n 3. For **Peered VPC network** , choose **In another project**.\n 4. For **Project ID** , enter the [tenant project ID](/data-fusion/docs/how-to/create-private-ip#find_your_tenant_project_ID).\n 5. For **VPC network name** , enter\n \u003cvar translate=\"no\"\u003eINSTANCE_REGION\u003c/var\u003e`-`\u003cvar translate=\"no\"\u003eINSTANCE_ID\u003c/var\u003e.\n\n Replace the following:\n - \u003cvar translate=\"no\"\u003eINSTANCE_REGION\u003c/var\u003e: the region in which you created your Cloud Data Fusion instance.\n - \u003cvar translate=\"no\"\u003eINSTANCE_ID\u003c/var\u003e: the ID of the Cloud Data Fusion instance.\n 6. For **Exchange custom routes** , click **Export custom routes**. This\n allows for exchanging any custom routes defined in your VPC network with\n the tenant VPC network.\n\n 7. Click **Create**.\n\n If the VPC Network Peering is successfully set up, the **Status** on the VPC\n network details page is **Active**.\n | **Note:** Create a firewall rule on your VPC network that allows for incoming SSH connections from the IP address range you specified when you created the private Cloud Data Fusion instance.\n\n### Create a managed private DNS zone\n\nTo resolve domain names in Cloud Data Fusion, create a new managed private\nDNS zone in the same VPC network or shared VPC network that was used for VPC\nnetwork peering. For more information, see\n[Create a private zone](/dns/docs/zones#create-private-zone). \n\n### Console\n\n\nTo create a private managed DNS zone, do the following:\n\n1. In the Google Cloud console, go to the **Create a DNS zone** page.\n\n [Go to Create a DNS zone](https://console.cloud.google.com/net-services/dns/zones/new/create)\n2. For **Zone name**, enter a name.\n3. For **Zone type** , click **Private**.\n4. For **DNS name**, enter a domain name.\n5. For **Options** , click **Default (private)**.\n6. For **Networks**, select the VPC network or shared VPC network that was used for VPC Network Peering.\n7. Click **Create**.\n\n### Create a record set in the DNS zone\n\nCreate the record set in the DNS zone that has the internal IP addresses to\nresolve when you design your pipeline. For more information, see\n[Add a record](/dns/docs/records#add_a_record). \n\n### Console\n\n\nTo create the record set, do the following:\n\n1. In the Google Cloud console, go to the **Cloud DNS** page.\n\n [Go to Cloud DNS](https://console.cloud.google.com/net-services/dns)\n2. Click the zone for which you want to create a resource record set.\n\n3. On the **Zone details** page, click **Add Standard**.\n\n4. For **DNS name**, enter a domain name that must be resolved during design\n time.\n\n5. Enter the record type details. For the IPv4 address, provide the internal\n IP address for the sink or source to be used in the pipeline. For more\n information about record types, see\n [Add a record](/dns/docs/records#add_a_record).\n\n6. Click **Create**.\n\nAdd DNS Peering in an instance\n------------------------------\n\n### Console\n\n\nTo create DNS peering in the Google Cloud console, do the following:\n\n1. Open your instance.\n\n 1. In the Google Cloud console, go to the Cloud Data Fusion page.\n\n 2. Click **Instances** , and then click the instance's name to go to the\n **Instance details** page.\n\n [Go to Instances](https://console.cloud.google.com/data-fusion/locations/-/instances)\n2. Click **Add DNS peering**.\n\n The **Add DNS peering** dialog opens.\n3. For **DNS peering ID**, enter a name.\n\n4. For **Domain**, enter the domain name that you used for creating the\n private DNS zone.\n\n5. For the **Target project**, select the project name where the private\n DNS zone was created.\n\n6. For the **Network**, select the VPC network name where the\n private DNS zone was created.\n\n7. Click **Save** to create the DNS peering.\n\n### REST API\n\n\nTo resolve domain and hostnames with the Cloud Data Fusion DNS Peering\nAPI, call its\n[`create()`](/data-fusion/docs/reference/rest/v1/projects.locations.instances.dnsPeerings/create)\nmethod.\n\nFor more information and methods, see the Cloud Data Fusion\n[DNS Peering API reference](/data-fusion/docs/reference/rest/v1/projects.locations.instances.dnsPeerings).\n\nDNS resolution in shared VPC networks\n-------------------------------------\n\nTo create the Cloud DNS private zones in a [shared VPC](/vpc/docs/shared-vpc)\nnetwork, create a\n[private zone](/vpc/docs/shared-vpc#shared_vpc_and_cloud_dns_private_zones) in\nthe host project and authorize access to the zone for the shared VPC network or\nset up the zone in a service project using\n[cross-project binding](/dns/docs/zones/cross-project-binding). For more\ninformation, see\n[Best practices for Cloud DNS private zones](/dns/docs/best-practices#best_practices_for_private_zones).\n\n### Required roles for shared VPC networks\n\n\nTo ensure that the Cloud Data Fusion Service Account has the necessary\npermissions to create a DNS peering in a shared VPC network,\n\nask your administrator to grant the Cloud Data Fusion Service Account the\n\n\n[DNS Peer](/iam/docs/roles-permissions/dns#dns.peer) (`roles/dns.peer`)\nIAM role on the shared VPC host project.\n\n\n| **Important:** You must grant this role to the Cloud Data Fusion Service Account, *not* to your user account. Failure to grant the role to the correct principal might result in permission errors.\nFor more information about granting roles, see [Manage access to projects, folders, and organizations](/iam/docs/granting-changing-revoking-access).\n\n\u003cbr /\u003e\n\n\nYour administrator might also be able to give the Cloud Data Fusion Service Account\nthe required permissions through [custom\nroles](/iam/docs/creating-custom-roles) or other [predefined\nroles](/iam/docs/roles-overview#predefined).\n\nFor more information, see\n[Granting access to the required service accounts](/iam/docs/granting-changing-revoking-access#granting-console).\n\nWhat's next\n-----------\n\n- Learn more about [Networking in Cloud Data Fusion](/data-fusion/docs/concepts/networking).\n- Refer to the [Cloud Data Fusion API](/data-fusion/docs/reference/rest/v1/projects.locations.instances.dnsPeerings)."]]
