Fixes drush-ops#6319. Update docs: import SQL dump using sql:connect not sql:cli

Author: weitzman

src/Commands/sql/SqlCommands.php

@@ -125,6 +125,8 @@ public function drop($options = ['extra' => self::REQ]): void
 
     /**
      * Open a SQL command-line interface using Drupal's credentials.
+     *
+     * To import an SQL dump, it is more efficient to use sql:connect than sql:cli. See Examples below.
      */
     #[CLI\Command(name: self::CLI, aliases: ['sqlc', 'sql-cli'])]
     #[CLI\Option(name: 'extra', description: 'Add custom options to the connect string (e.g. --extra=--skip-column-names)')]
@@ -133,7 +135,8 @@ public function drop($options = ['extra' => self::REQ]): void
     #[CLI\Topics(topics: [DocsCommands::POLICY])]
     #[CLI\Usage(name: 'drush sql:cli', description: 'Open a SQL command-line interface using Drupal\'s credentials.')]
     #[CLI\Usage(name: 'drush sql:cli --extra=--progress-reports', description: 'Open a SQL CLI and skip reading table information.')]
-    #[CLI\Usage(name: 'drush sql:cli < example.sql', description: 'Import sql statements from a file into the current database.')]
+    #[CLI\Usage(name: '$(drush sql:connect) < example.sql', description: 'Bash: Import SQL statements from a file into the current database.')]
+    #[CLI\Usage(name: 'eval (drush sql:connect) < example.sql', description: 'Fish: Import SQL statements from a file into the current database.')]
     public function cli(InputInterface $input, $options = ['extra' => self::REQ]): void
     {
         $sql = SqlBase::create($options);