[[["容易理解","easyToUnderstand","thumb-up"],["確實解決了我的問題","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["難以理解","hardToUnderstand","thumb-down"],["資訊或程式碼範例有誤","incorrectInformationOrSampleCode","thumb-down"],["缺少我需要的資訊/範例","missingTheInformationSamplesINeed","thumb-down"],["翻譯問題","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["上次更新時間：2025-07-31 (世界標準時間)。"],[],[],null,["# Looker-hosted infrastructure migration information\n\nLooker is in the process of upgrading our hosting infrastructure to deliver better scalability and reliability. This upgrade will also give you access to new Looker features as they are developed.\n\n\n**You will need to take action to ensure continued, uninterrupted service.** Looker is working hard to make this transition as seamless as possible. The following instructions provide details. Please review them and reach out to [Looker Support](/looker/docs/best-practices/looker-support-details) or your Looker team if you need any assistance or have any questions.\n\n\nAlso, please be aware that, upon upgrade, all your [persistent derived tables](/looker/docs/derived-tables#adding_persistence) will rebuild. This may cause additional load to your database.\n\nConnecting Looker to your database\n----------------------------------\n\n\nThere are two ways Looker may be talking to your databases. Both will require updates to ensure continued data access. You may have several databases, each using different techniques.\n\n### IP address allowlist\n\n\nIf you're connecting Looker to your database by allowing specific IP addresses through your network layer, you will need to add a new IP to your list of allowed addresses on your network. This step can be done ahead of time. See the [Enabling secure database access](/looker/docs/enabling-secure-db-access#option_1:_ip_address_allowlist) documentation page if you are unfamiliar with the process.\n\n1. The list of IP addresses that are needed to allow network traffic from your Looker instance can be found on the Connections page in the Admin panel. Click Public IP Addresses and copy the IP address(es) that are shown. Visit the [Enabling secure database access](/looker/docs/enabling-secure-db-access#next_generation_hosting) documentation page for a complete list of regions and IPs.\n2. Allow access to the necessary IP addresses through your networking layer (the specific method will depend on the database in question). Don't remove the legacy IPs at this time.\n\nSSH tunnel\n----------\n\n\nIf you're connecting Looker to your database through an SSH tunnel, your tunnel configurations will carry over to the new infrastructure. The only action you will need to take will be to update your allowed IP addresses on your network. See the [Using an SSH tunnel](/looker/docs/using-an-ssh-tunnel) documentation page if you're unfamiliar with using SSH tunnels.\n\n1. The list of IP addresses that are needed to allow network traffic from your Looker instance can be found on the Connections page in the Admin panel. Click Public IP Addresses and copy the IP address(es) that are shown. Visit the [Enabling secure database access](/looker/docs/enabling-secure-db-access#next_generation_hosting) documentation page for a complete list of regions and IPs.\n2. Allow access to the necessary IP addresses through your networking layer (the specific method will depend on the database in question). Don't remove the legacy IPs at this time.\n\nConnecting Looker to third-party services\n-----------------------------------------\n\n\nYou may have additional services that Looker communicates with. As explained in the [**IP address allowlist** section](#ip-address-allowlist), your next-generation Looker instance will have a different outbound IP address, and Looker won't be able to connect if you are restricting access.\n\n\nNotable examples of services include GitHub Enterprise accounts or a [local action hub server](/looker/docs/action-hub#setting_up_a_local_action_hub_server). These allowlist IP addresses also apply to SFTP and SMTP destinations and for LDAP servers that restrict IP traffic.\n\n\nIf your infrastructure relies on lists of allowed IP addresses for connections to specific services, you need to update these lists the same way you would to allow database access.\n\n1. The list of IP addresses that are needed to allow network traffic from your Looker instance can be found on the Connections page in the Admin panel. Click Public IP Addresses and copy the IP address(es) that are shown. Visit the [Enabling secure database access](/looker/docs/enabling-secure-db-access#next_generation_hosting) documentation page for a complete list of regions and IPs.\n2. Allow access to the necessary IP addresses through your networking layer (the specific method will depend on the service in question). Don't remove the legacy IPs at this time.\n\n*** ** * ** ***\n\n\n**NOTE: The following section is only relevant if you are changing your hosting environment to Google Cloud. No need to read further unless you or someone at your organization has had discussions with Looker about changing from the historical default hosting provider of Amazon Web Services (AWS) to Google Cloud.**\n\nAccessing Looker via the API - Google Cloud only\n------------------------------------------------\n\n\nConnecting to Looker from your browser will not change; humans can continue to do what they have always done. If you are using the Looker API, you may need to take action to ensure uninterrupted service. If you are not sure, you can use this [System Activity](/looker/docs/usage-reports-with-system-activity-explores) query to see if there has been recent API usage on your instance:\n\n\n```\n \u003cyour_instance_url\u003e/explore/system__activity/event?\n fields=event.created_week,event.count,event.category\n &f[event.is_api_call]=Yes&sorts=event.created_week+desc\n &limit=500&total=on&row_total=right\n &vis={}\n &filter_config={\"event.is_api_call\":[{\"type\":\"is\",\"values\":[{\"constant\":\"Yes\"},{}],\"id\":0,\"error\":false}]}\n \n```\n\n\u003cbr /\u003e\n\n\nIf there are no results, you are not using the API and don't have to take any further action.\n\n### Custom API host URL - Google Cloud only\n\n1. Check [Admin -\\\u003e API](/looker/docs/admin-panel-platform-api) to see if there is a value set for **API Host URL**.\n2. If a value *is* set, you don't need to do anything further.\n3. If a value *is not* set, you have a choice: either set a value using the instructions on the [Admin settings -\\\u003e API](/looker/docs/admin-panel-platform-api) documentation page and update your API processes to use it (recommended, as it will allow you to make the configuration changes ahead of time without loss of service), or proceed to the [Specifying an API port](#specifying-an-api-port---google-cloud-only) section.\n4. After configuring your custom API host URL in the Looker application, you will need to update your API processes to connect via that URL rather than specified port numbers (for example, `https://my.api.looker.com` rather than `https://my.looker.com:19999`).\n\n### Specifying an API port - Google Cloud only\n\n\nIf you do not use a [custom API host URL](/looker/docs/admin-panel-platform-api#api_host_url), you will need to update your API processes to connect to a new port. Our next-generation hosting infrastructure uses port `443`. If you are not using a [custom API host URL](/looker/docs/admin-panel-platform-api#api_host_url), update from the current default API port of `19999` to port `443`.\n\n\nLocate your API processes, and change the API port references from 19999 to 443 (for example, use `https://my.looker.com:443` rather than `https://my.looker.com:19999`).\n\n\n**This technique cannot be used without a service interruption.**If you choose to update the port in your API processes prior to the upgrade, the processes will not be able to access your Looker instance until the upgrade is complete. For this reason, we recommend that you do it immediately prior to the scheduled upgrade.\n\n\nIf you choose to update your processes after the infrastructure upgrade, automated processes will not be able to access your Looker instance during the period in between the upgrade and the time the port change is complete."]]
